> For the complete documentation index, see [llms.txt](https://evidano.gitbook.io/ailyze-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://evidano.gitbook.io/ailyze-docs/troubleshooting/image-to-text-issues.md).

# Image to Text Issues

Fixes for Image to Text problems, from files that will not upload to pages that come back unreadable or stay queued.

This page helps you fix problems that come up when you turn images or PDFs into text.

## "Images and PDFs cannot be uploaded together"

One project holds either images or PDFs, so the second kind is refused.

1. Click the remove icon on the files already uploaded, or start a second project for the other kind.
2. Remember that each PDF becomes its own project in any case.

## "The server is still splitting these files into pages"

A PDF is turned into one image per page before the wizard can continue, and large PDFs take a moment.

1. Wait until the row under the PDF shows its page count instead of "Preparing pages…".
2. Click **Next Step** again.

## "The sample transcription misses words, or invents them"

The language and domain set the instructions the model follows, so a wrong pair gives a wrong reading.

1. Click **Back to Previous Step** and check that the **Language** matches the writing, not the country, and that the **Domain** matches the material. For mixed or unknown languages, try **Auto-detect**.
2. Add an instruction to the **Transcription prompt**, such as the abbreviations used on the page, then click **Transcribe again**.
3. Click **Retry with a more advanced AI model**. It reads faint or cursive writing better; check the price difference in [Plans, Limits & Credits](/ailyze-docs/reference/plans-limits-and-credits.md).
4. Re-photograph the page if you can. Even light, no shadow across the text, and the page filling the frame help more than any prompt.

## "Too many previews. Please wait a moment and try again."

Sample runs are free, but only a handful can run each minute.

1. Wait a minute, then click **Transcribe again**.

## "A page shows Failed, or says no text was found"

The run can fail on a damaged file, and a blank or very faint page gives no text.

1. On the **Image to Text** list, click **Retry** on the page's card. It runs the page again with the advanced model and your language and domain (not an edited prompt).
2. If it fails again, open the image on your computer to confirm it is not blank or corrupted, and re-export it as PNG or JPG.
3. For a PDF page, re-export the PDF from its source at a higher resolution and start a new project.

## "I was told to upgrade, or to top up"

Pages beyond the free allowance are paid, and the rules differ by plan.

1. On the Free plan, the wizard stops once your free pages are used; upgrade to Pro to continue.
2. On a paid plan, the **Confirm image transcription charge** dialog shows the cost. If your balance is short, top up from the dialog or choose the smaller test batch it offers.
3. Allowances, rates, and the minimum top-up are listed in [Plans, Limits & Credits](/ailyze-docs/reference/plans-limits-and-credits.md).

## "The pages have been Queued for a long time"

Transcription runs in the background and this workflow does not send an email.

1. Keep the **Image to Text** list or the project open: both update themselves while pages are transcribing. **Refresh** reloads them by hand.
2. A page that ends up **Failed** can be rerun with **Retry** on its card.

## "My pages say Not started"

The pages were uploaded but never sent for transcription, for example because you left the wizard, or chose **Test with 10 images first** and these were not among the ten.

1. Click a **Not started** page, or **Continue setup** in the project, to reopen the wizard with those pages.
2. Choose the language and domain, check the sample, and start the run.

## "I can't find my project"

The list shows pages, not projects, so a project is easy to lose among others.

1. Find it in the **Projects** sidebar (use **Search projects…** when you have many) and click it to open it, or search the list by **Project & file name**.
2. Note that **Delete all files** removes every page, so a project whose pages were all deleted no longer appears.

For the full walkthrough, see [Convert Images & PDFs to Text](/ailyze-docs/prepare-research-data/convert-images-and-pdfs-to-text.md).