Skip to main content
Import & metadata

AI analysis didn't find a value or can't process a file

Why a metadata field stays empty or shows the wrong value, and how to get better AI results.

Written By Sebastian

Last updated About 6 hours ago

The AI analysis reads each document and fills in its metadata. If a field stays empty, shows a wrong value, or the analysis doesn't run at all, one of the causes below is usually responsible.

Available on all plans

A field stays empty

Check these in order:

  1. Is the value in the document? The AI only extracts what's written. If the contract doesn't state an end date, the field stays empty.

  2. Is the field assigned to this document type? Go to Account Settings → Metadata, open the field and check Specify relevant document types. Fields are assigned to document types, not to templates. See Document types: set up and customise.

  3. Is the field included in AI analysis? Open the field and check that Use this metadata in AI analyses is on.

  4. Is the document type correct? If the AI picked the wrong type, it looked for the wrong fields. Change the type and run the analysis again.

A value is wrong

  • Improve the field's description and prompt: say where the value usually is, what format to return, and what to do if it's missing. See Create custom metadata the AI can extract.

  • Split fields that ask for more than one thing.

  • For dates, check whether the contract has a signing date and a different start date.

  • Correct the value manually and confirm it. Confirmed values aren't overwritten unless you choose to.

The analysis didn't run or shows an error

What you seeWhat to do
Not processableThe file's structure can't be read. Save it as a plain PDF and upload it again. See A PDF won't upload or shows errors.
EncryptedEnter the PDF password when fynk prompts you. If unlocking fails, remove the protection in a PDF tool you have permission to use and upload a copy. Password-protected files in file storage cannot be viewed inside fynk.
The analysis seems stuckEach document takes about 1–3 minutes. Large imports are processed one after another, so wait a while, then reload the page.
No analysis and no errorCheck that you have AI credits left. See AI credits: allowance, top-ups and usage.

Run the analysis again

After fixing the cause, run the analysis again for just the fields you changed. See Fill new metadata on existing documents.

When you test a changed description, use a newly uploaded document. Running it again on the same document can show the previous result. [CHECK]

Good to know

  • Poor scans give poor results. If a scan is hard for you to read, the AI will struggle too.

  • Text recognition works best for languages written in Latin script. Results for other scripts, such as Cyrillic, Chinese or Japanese, may be less reliable. [CHECK]

  • Calculations, such as adding up several amounts, aren't reliable. Extract the parts instead.

Still need help? Share an idea