A document is stuck in "Needs review"

02What you're seeing

A document has the Needs review badge and the amber strip at the top of your Files page is still counting it. Hours, maybe days have passed. It is not resolving on its own.

03Most likely cause

It is waiting for you. Needs review is not an "in-progress" state, it is a "user input required" state. Hemma reads every invoice twice and has a third model settle the differences against the document itself. What is left over is the small remainder Hemma is not confident enough to file without your glance, plus documents whose type is unclear. It hands those to you and waits.

The fix: Open the document. The detail page becomes a review screen. Pick the right type, or hold the details Hemma read next to the document and tap Confirm details. The document moves to Trusted immediately.

See reviewing and correcting what the AI extracted for the full walkthrough of each review screen.

04Other things to check

• You confirmed but the badge did not change. Refresh the page. The strip polls every few seconds and the badge updates with it. If it still shows after a refresh, the confirmation may not have saved — check your network connection and try again.

• The document is one of several waiting. The amber strip shows the total count, not which document. Tap Needs review on the strip to filter the Files list to just the ones that need you. Walk them in order.

• You see "Help me identify" but the dropdown does not have the right type. Pick Other. Hemma stores the file untouched and you can rename and tag it from the detail page.

• It is about a field that does not matter to you. Confirm anyway. Confirming is what unlocks the budget impact downstream: without it, the invoice never counts toward your spend.

• A value on the screen is wrong. Confirm anyway, then edit the field on the detail page afterwards. The audit log captures both events.

• The document is from before you joined the project. Anyone on the project can resolve a review — it does not have to be the person who uploaded it. If the original uploader is unavailable, do it yourself.

05What it does not mean

• Hemma is not "still thinking". Processing takes about thirty seconds and is done long before the review state appears. Once the badge shows, no background work is happening.

• It is not a bug or a stall. A document landing in Needs review is the system catching uncertainty rather than masking it. Now that Hemma settles the differences between its own readers itself, it happens a good deal less often than it used to.

06If none of this worked

If a review screen will not load, or the Confirm button does nothing after multiple tries, email hello@gethemma.app with:

• The document name and the URL of the detail page (so we can pull the document ID).
• Which review type you saw (type unknown / details check / items check / invoice number check).
• A screenshot if anything looked off.

We can dig into the extraction record from there.

07Related

• Reviewing and correcting what the AI extracted
• How AI document processing works
• The AI extracted the wrong amount or contractor