Articles on: AI & contract analysis

Optimizing AI Prompts — Get Better Results from Contract Analysis

Your benefit


ContractHero's AI reads your contracts and fills in data fields automatically — terms, notice periods, custom fields. How well it works depends directly on how your prompt is written. The payoff for getting it right: less manual correction and more reliable reports.


The ground rules are in the main article. How a prompt has to be worded, and the ready-made templates per field, are in How to write a prompt in ContractHero. This article focuses on the three buttons under the prompt field and on getting an existing prompt to land better.


The rule in one line


A prompt is a question — not an instruction and not a description.


  • ✅ "What notice period applies?"
  • ❌ "Extract the notice period."
  • ❌ "The remaining term of the contract"


Older prompts written as instructions or descriptions still work — they just land less often. If a field fills unreliably, rewording it as a question is the first thing to try.


Two things follow:


  • One question per field. If you need two values, create two fields.
  • Precision beats enumeration. Use the term that actually appears in your contracts. Piling up synonyms and examples dilutes the signal the AI searches on and can lower the hit rate.


Tips for prompts that land


  1. Go to Settings → Field builder → Contract field builder and open a field via its gear icon (or create a new one).
  2. In the box under "Optional: Tell AI to extract the key details by giving a specific description related to this field", write a short, precise question about the information you want to extract.
  3. Use terms that actually appear in the contract — the AI works with the document's language.
  4. Keep the field name and the prompt aligned. If the field is called "Payment", the prompt should ask about payment, not salary.
  5. Put exceptions, filters and format rules in the instruction, not the prompt.
  6. Save with Update.


What you DON'T need to include in the prompt:


  • List options: For list fields, the AI automatically recognizes the available values. You don't need to list or mention them — asking for the information alone is enough ("Which item is being leased?"). What matters instead is that the options themselves are unambiguous.
  • Date format: The format follows your account settings automatically. No need for "Enter the date in DD.MM.YYYY format."
  • Field type: The AI already knows whether it's a text, date, or list field.


The three buttons under the prompt field


  • Test in a contract — pick an existing contract and see immediately what the prompt returns, before the field goes live.
  • Improve prompt (wand icon) — has the AI rewrite your prompt. See below.
  • Re-analyse field — runs the analysis for this field again.


Common questions


What if I have no idea how to phrase the prompt?
Then have one suggested to you. Open the contract where the extraction is failing, switch to the Assistant tab, and ask for a wording — for example: "What prompt do I need so the AI picks up the notice period from this contract?"


The advantage over writing one yourself: the assistant has the contract text in front of it and can work from the actual wording of your document. That makes it a fast starting point when you are setting up new fields.


Enter the suggestion on the field in question and check it with Test in a contract before putting it live. It is a starting point, not a verified result.


No Assistant tab on your contracts? The contract assistant is not enabled on every account. Talk to your Customer Success Manager or email support@contracthero.com — we're happy to help you phrase the prompt in the meantime.


Should I write prompts short or detailed?
Short and precise. A clear question beats a paragraph of context. If a prompt isn't landing, the fix is usually a better-matched term from the document — not more words.


Will my existing prompts still work?
Yes. Prompts written as instructions or descriptions are still processed. They simply land less reliably than questions, so they are worth revisiting when a field gives trouble.


Do I need different prompts for different contract categories?
Not necessarily. But if you notice a prompt isn't working well for a specific contract type, it can help to create a tailored prompt for that category — using terms that are common in those contracts.


What is prompt improvement?
Improve prompt (the wand icon under the prompt field) has the AI rewrite your prompt into a clearer question. Two things to know before you use it:


  1. It replaces your prompt in place. Your wording is overwritten in the input field, not shown alongside it. If you want the original back, close the dialog with Cancel — or copy your prompt somewhere safe first.
  2. It may also fill the instruction field. If the AI thinks a special rule is needed, it writes one into Optional: Filters and special instructions, even if that box was empty before. Open the section and check what it put there.


The result is an untested suggestion. It often catches common mistakes — listed dropdown options, unnecessary format instructions — but it is not automatically better than what you wrote. Check it with Test in a contract, then save with Update only if you are happy.


What is the difference between prompt improvement and the contract assistant?
Prompt improvement sharpens a wording you have already written, and overwrites it. The contract assistant proposes a new one in the chat, and it knows the contract text while doing so. If you already have a prompt that simply isn't hitting well enough, use Improve prompt. If you have nothing yet, ask the assistant. Both give you suggestions you should test.


Does this apply to contact fields too?
Yes, the same wording rules apply in the contact field builder. The one difference: there is no instruction field for special rules there, because the contact field builder has fewer field types.


Good to know


  • Improve prompt overwrites. Keep a copy of a prompt you care about before running it, or use Cancel to back out.
  • Check the instruction box afterwards. Improve prompt can add a special rule there without being asked.
  • Terms in "quotation marks" are not translated by Improve prompt — useful when you need to match a technical, legal or proper name exactly as it appears.
  • One precise term beats a list of synonyms. If "term" and "contract duration" are both in use across your contracts, pick the one that fits that category rather than stacking both into one prompt.
  • The AI is continuously being improved. New OCR technology and enhanced analysis features deliver even more accurate results — including for tables and scanned documents.
  • Jump to Source shows you exactly where in the document an extracted value came from — see the related article below.



Updated on: 10/28/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!