# Documents and text in photos

Source: https://frameleaf.app/docs/using/documents/

Never hunt for that receipt again. Frameleaf reads the text in your photos: receipts, signs, letters, screenshots, anything with words in it. Search by that text, copy it straight out of the photo, and correct any line that was misread.

## The Documents view

**Documents**, under Explore in the sidebar, gathers every photo that has text in it and says how many there are. Use **Search text in your photos** to find photos by that text, or by your own corrections to it.

Photos appear here once their text has been read, which happens soon after they arrive. Text is read automatically and can contain mistakes, so check anything that matters against the photo.

Text in photos is also part of the main [search](https://frameleaf.app/docs/using/search/): choose the **Text in photos** search mode, or type `text:` and a word. See [Search syntax](https://frameleaf.app/docs/using/search-syntax/).

## Text in this photo

Open a photo and its **Info** panel ends with **Text in this photo**, below the map. It shows:

- the text as it reads now
- **Show text regions**, which draws where each line is on the photo
- **Select text** and **Copy text**

### Review a photo's text

If the photo is yours, you can also review its text:

| Action | What it does |
| --- | --- |
| **Correct** | Fix a line that was misread. Your correction is kept beside the recognised text, never over it, so the original reading stays on record |
| **Dismiss** | Hide a line that's just noise. **Restore** brings it back |
| **Show where** | Points at the line on the photo. Hovering over or focusing a line does the same |
| **Read text again** | Runs text recognition on this photo again |

**Read text again** uses the computer your administrator chose for text recognition. If text recognition is switched off, or no computer has been chosen for it, Frameleaf tells you and leaves the text as it is.

People you share the photo with see the text with your corrections applied and without the lines you dismissed. Only you see your review itself.

### When the photo changes

- **Read again.** Your corrections follow the line that now covers the same place in the photo. If the new reading differs from the text you corrected, the line says so. A correction whose text has gone entirely is kept as your own text.
- **Cropped.** Text that a crop removes is no longer read, listed or searchable, and your corrections to it are hidden while the crop hides it. Search on a cropped photo only matches its visible text and values you typed yourself. Remove the crop and it all comes back.
- **Locked.** A [Locked](https://frameleaf.app/docs/using/private-content/) photo's text is part of the photo. It's listed and readable only while your session is unlocked, and locking again clears it from the list and from an open Info panel.

## Suggested details

Pull the key details out of receipts and documents in a click. When your administrator turns on **Suggest receipt details** (off by default; see [For administrators](#for-administrators)), the panel shows **Suggested details** read from the photo's text:

- **Date**
- **Total**
- **Reference**
- **Email**
- **Phone**

Each suggestion shows what the text says, where it was read and how confident the recognition was. You have the final word: a clearly read "12.50" can still be the wrong total, and Frameleaf leaves the order of day and month in a date for you to confirm.

For each suggestion you can:

- **Confirm** it, or pick one of the **Other readings**
- **Correct** it to your own value
- **Dismiss** it
- **Reset** your decision so the suggestion shows again

## Changes on two devices

Your edits are safe across devices. Every change is checked against the version of the text you were looking at. If the photo was read again, or you changed the same line on another device in the meantime, the panel reloads with the latest text instead of overwriting it. Just make your change again.

## Preservation

Your corrections travel with your photos in a [preservation package](https://frameleaf.app/docs/using/preservation/), and are restored wherever your library doesn't already have corrections of its own.

## For administrators

Reading text is set in **Settings**, then **Search & intelligence**, then **Text, documents & receipts**:

| Setting | What it does | Default |
| --- | --- | --- |
| **Read text in photos** | Makes signs, receipts and documents searchable by the words in them. Turned off, words already read stay searchable and new photos are not read. | On |
| **Languages to read** | One group of alphabets at a time. Choose the one most of your photos use. | Chinese, Japanese and English |
| **How much to read** | **Clear text only** (signs, headings and printed pages, with the fewest mistakes), **Balanced** (signs, receipts and printed pages) or **Faint text too** (also faded receipts and handwriting, with more words wrong) | Balanced |
| **Read small print** | Reads the fine print on receipts and documents. Slower, and needs more memory. | Off |
| **Suggest receipt details** | Shows **Suggested details** on photos with text. Suggestions stay editable and show where they were read from. | Off |

The language groups are: English, French, Spanish and similar; English only; Chinese, Japanese and English; Chinese, Japanese, English and Latin-script languages; Chinese, English and Latin-script languages; Korean and English; Russian, Ukrainian and similar; Greek and English; and Thai and English.

**Advanced: text model and numbers** holds the **Text-reading model** and the numbers behind the choices above: **How clear text must be to be noticed** (0.5), **How sure a word must be to be kept** (0.8) and **Detail used for reading text** (736, or 1,280 with **Read small print** on). Two language groups have a larger model that reads more accurately and is several times slower.

A change applies to new photos straight away. To read the text in the photos you already have again, choose **Do it all again** on **Reading text in photos** in **Settings**, then **Computers & background work**, then **Background work**. Search keeps finding the words already read meanwhile.
