FilePlot user guide
Everything you need to get your documents organised, step by step.
Getting started
FilePlot needs no account and no setup. Open it and add your first documents.
- Open FilePlot. The first screen offers Import Documents and Try Samples.
- Try the samples if you'd like to see what FilePlot does first. They're invented documents in several languages, and you can delete them at any time.
- Import your own files. FilePlot reads each one and shows the result in Documents.
- Check anything marked "Needs review". The Dashboard lists these under Waiting for you.
Finding your way around
| Section | What it's for |
|---|---|
| Dashboard | Your library at a glance, documents waiting for review, and recent imports |
| Documents | Every document, with filters by type, status and language |
| Categories | Your folders for organising the library |
| Search | Search across names, text, details and tags |
| Workflows | Steps FilePlot repeats for you |
| Languages | Which languages FilePlot can read on this device |
| Local AI Models | On-device model options and your device's performance profile |
On iPhone, Categories, Workflows, Languages, Local AI Models and Settings are under More.
Adding documents
Import files
Click or tap the + button and choose files. You can choose many at once. On a Mac, you can also press ⌘O or drag files anywhere into the window.
Scan paper (iPhone and iPad)
Tap +, then Scan Document. Capture each page, then tap Save. FilePlot turns the pages into one PDF and reads it. Hold the camera steady, in good light, so the text is sharp.
Share from another app
In Mail, Files, Safari or most other apps, use the Share button and choose FilePlot. The documents appear in your library the next time you open FilePlot.
From Finder (Mac)
Right-click files in Desktop, Documents or Downloads and choose Analyse with FilePlot. If you don't see it, turn on FilePlot's Finder extension in System Settings › General › Login Items & Extensions. You can also use Services › Analyse with FilePlot.
Supported files
| Kind | Formats |
|---|---|
| Digital and scanned PDFs, including password-protected ones | |
| Images | JPEG, PNG, HEIC, TIFF |
| Office | Word (.docx), Excel (.xlsx), PowerPoint (.pptx) |
| OpenDocument | .odt, .ods, .odp |
| Text and data | Text, Markdown, RTF, HTML, CSV, JSON, XML, source code |
| Other files | Kept in your library as attachments, without analysis |
FilePlot reads the text in Office files, not their layout or images. Older .doc and .xls files aren't supported yet. If you import a file that's already in your library, FilePlot recognises it and keeps a single copy.
What FilePlot finds
Open any document to see what FilePlot found. Each document has five tabs.
| Tab | Shows |
|---|---|
| Overview | The suggested name, document type and confidence, summary, tags and similar documents |
| Details | Dates, amounts, invoice and reference numbers, IBANs, tax numbers, companies, people, addresses, emails, phone numbers and websites |
| Text | The text of each page, with its language and, for scans, how clearly it was read |
| Languages | Every language in the document, how much of it each takes up, and which page is in which language |
| History | Each processing step, and anything that didn't work |
Confidence
A bar shows how sure FilePlot is. Green means confident, amber means worth a look, and red means it's a guess. Each detail also says where it came from, such as "Found in the document", "Suggestion" or "Confirmed by you".
Document status
| Status | Meaning |
|---|---|
| Ready | Everything worked |
| Processing | FilePlot is still reading it |
| Needs review | Something is uncertain, such as a faint scan or an unclear document type |
| Failed | The document couldn't be read. History explains why |
| Out of date | You deleted its extracted data. Choose Reprocess to read it again |
FilePlot checks some details for you. IBANs and Greek tax numbers are only shown when their check digits are valid, and impossible dates such as 31 February are ignored.
Reviewing and correcting
Open a document and choose Review. You can change:
- the document type
- the filename
- its category and tags
- any detail, including adding missing ones or removing wrong ones
Choose Save when you're done. Your corrections are kept even if the document is read again later.
Reading a document again
Choose More (…) › Reprocess in a document, or swipe right on it in the list on iPhone. On a Mac, select documents and press ⌘R.
Password-protected PDFs
FilePlot asks for the password in the document's Overview. Enter it and choose Unlock. The password is used once and isn't stored.
Names and exporting
FilePlot suggests a name built from the document's date, type, company and number, for example:
2026-11-02_Invoice_Acme_INV-1042.pdf
Choose Use This Name to accept it, or Edit to change it. Names keep letters from every language, so a Greek company name stays in Greek.
Changing the name format
In Settings › Suggested filenames, add a prefix or suffix. A preview shows the result.
Exporting
The approved name is used when you export a copy. In Documents, select the documents, choose Export in the bar at the bottom, and pick a folder. FilePlot never overwrites a file there: it adds a number instead, such as Invoice-2.pdf.
Searchable PDFs
For a scanned PDF, choose More (…) › Create Searchable PDF. FilePlot saves a copy with a hidden text layer, so you can search and select its text in other apps.
Categories and tags
Categories are folders inside FilePlot. Your files stay where they are.
- Suggested categories: each document type has one, such as Finance/Invoices. Choose the suggestion in a document's Overview to file it there.
- Your own categories: in Categories, choose New Category. Pick a name, a colour and, if you like, a parent category.
- Several documents at once: select them in Documents and choose Categorise.
- Tags: add them in Review, separated by commas, or select documents and choose Tag.
To edit or delete a category, right-click it on a Mac, or touch and hold it on iPhone and iPad.
Searching
Open Search and start typing. FilePlot searches names, the text of every page, extracted details, tags and summaries. Results appear as you type, and matches are highlighted.
- Accents and capitals don't matter: τιμολογιο finds Τιμολόγιο.
- Chinese and Japanese work too, without spaces between words.
- Names and details rank above words buried in long text.
To filter rather than search, use the filter button in Documents to show one type, status or language.
Spotlight
Turn on Settings › Show in Spotlight to find documents from system search. Only names and types are added, never document text, and sensitive documents are always left out.
Summaries
Each document gets a short summary, with a longer one under Show More. It also lists key dates, amounts, parties, obligations and suggested next steps, such as adding a due date to your calendar.
- On devices with Apple's on-device model (macOS, iOS and iPadOS 26 or later, on supported hardware), you can turn on Use for summaries in Local AI Models for written summaries.
- Otherwise, FilePlot quotes the document's most important sentences, so nothing is invented.
To turn summaries off, use Settings › Generate summaries.
Workflows
A workflow repeats the same steps for you. FilePlot includes three:
- File invoices: reads an invoice, suggests a name, and files it under Finance/Invoices once you confirm.
- Make scans searchable: recognises the text and saves a searchable PDF.
- Summarise for review: creates a summary and adds the tag Review.
Running a workflow
In Workflows, choose Run, pick the documents, and choose Run again. Before anything is renamed or moved, FilePlot shows exactly what will change and waits for you to choose Apply Changes.
Making your own
Choose New Workflow, give it a name, and add steps. FilePlot tells you if anything is missing, such as a tag name. A step that renames or moves documents must come after an Ask for confirmation step.
You can export and import workflows as a file from Settings. Imported workflows start switched off, so you can check them first.
Languages
FilePlot recognises 440 languages in 74 writing systems in the text of your files. It works offline, and handles documents that mix languages page by page and paragraph by paragraph. Arabic and Hebrew text is shown right to left.
Scans and photos
Text in a scan or a photo is read with Apple's text recognition, which covers fewer languages and depends on your system version. Open Languages to see how many your device can read in scans. Languages with a scan icon are supported.
If a scan is in a script your device can't read, FilePlot marks it Needs review rather than showing text that might be wrong.
Choosing languages for scans
Scan language detection is automatic. If you mostly scan in particular languages, choose them in Settings › Languages for scans for better results.
Backup and iCloud Sync
Backing up to a folder
In Settings, choose Back Up Now and pick a folder, such as an external drive. Later backups only copy new files, and every copy is checked. Settings shows the date of your last backup, and turns it orange after 30 days as a reminder.
To restore, choose Restore and pick the backup folder. Restoring only adds what's missing, so it never deletes anything in your library.
iCloud Sync
Turn on iCloud Sync in Settings to keep your library the same on your Mac, iPhone and iPad. It's off until you turn it on.
- Your documents and your edits, such as names, types, categories, tags and workflows, are stored in your own iCloud account.
- Reading, search and summaries still happen on each device, so a newly synced document may take a moment to appear in search.
- The sync icon in the toolbar shows when FilePlot last synced. Click or tap it for details.
- You need to be signed in to iCloud with iCloud Drive turned on, and have enough iCloud storage.
When you delete a document, its synced copy is kept in iCloud for 30 days before it's removed.
Privacy controls
- Sensitive documents: medical, identity, banking and legal documents are marked with a lock, and are never added to Spotlight.
- Exclude from AI: in a document, choose More (…) › Exclude from AI. You can also exclude a whole category when you edit it.
- Delete extracted data: choose More (…) › Delete Extracted Data to remove a document's text, summary and details, while keeping the file.
- Delete a document: select it and choose Delete. This removes FilePlot's copy and everything extracted from it. Files elsewhere on your device aren't touched.
See the Privacy Policy for the full details.
Shortcuts and widgets
Shortcuts
FilePlot adds these actions to the Shortcuts app:
- Import Document and Process Documents
- Analyse Document and Classify Document
- Extract Text, Generate Summary and Suggest Filename
- Find Documents, which you can also run by saying "Find documents in FilePlot" to Siri
Files passed to these actions are added to your library.
Widget
Add the FilePlot widget to see how many documents you have and how many need review. It never shows names or content, so it's safe on a Lock Screen.
Mac tips
| Keys | Action |
|---|---|
| ⌘O | Import documents |
| ⌘R | Reprocess the selected documents |
| ⌘. | Stop the current batch |
| ⌘1 to ⌘7 | Go to a section |
| ⌥⌘I | Show or hide the inspector in Documents |
| ⌘, | Open Settings |
In Documents, double-click a row to open it, and right-click for more actions. Columns can be sorted by clicking their headings.
Troubleshooting
A document says "Needs review"
FilePlot wasn't sure about something. Open the document and check History for the reason. Usually it's a faint scan or an unclear document type. Correct it in Review, and the status changes to Ready.
A scan was read badly
Scan again in good, even light, with the page flat and filling the frame. If the document is in a language your device can't read in scans, check the Languages screen. Choosing the scan language in Settings can also help.
"This file type isn't supported yet"
FilePlot keeps the file in your library as an attachment, but can't read it. If it's an older .doc or .xls file, save it as .docx or .xlsx and import it again.
"This file looks damaged or isn't what its name suggests"
FilePlot checks what a file really is, not just its extension. The file may be damaged, or have the wrong extension. Try opening it in the app that created it and saving a fresh copy.
"FilePlot no longer has permission to read this file"
Choose the file again with Import. This can happen if the file moved, or was on a drive that's no longer connected.
A batch import stopped part way
One failed file never stops the others. The message at the bottom says how many failed and why. If FilePlot was closed during a batch, it continues the next time you open it.
Search doesn't find a document
Check the document's status: one that's still processing, failed, or had its extracted data deleted can't be searched. You can also choose Settings › Rebuild Search Index.
iCloud Sync isn't updating
Make sure you're signed in to iCloud, iCloud Drive is on, and you have free iCloud storage. Sync on another device can take a few minutes. Opening FilePlot on that device also starts a sync.
"Analyse with FilePlot" is missing in Finder
Turn on FilePlot's Finder extension in System Settings › General › Login Items & Extensions. It appears for files in Desktop, Documents and Downloads. For other folders, use Services › Analyse with FilePlot or drag the files into FilePlot.
Questions
Do my documents leave my device?
Not for processing: reading, classifying and summarising all happen on your device, and work in Airplane Mode. If you turn on iCloud Sync, your documents are stored in your own iCloud account. FilePlot has no server of its own.
Does FilePlot change my files?
No. FilePlot works on its own copy. Approved names apply when you export a copy.
Do I need an account?
No. There's no FilePlot account. iCloud Sync uses your Apple Account if you turn it on.
Where is my library stored?
In FilePlot's private storage on each device. Use Backup to keep a copy somewhere else.
Can I trust the details FilePlot finds?
They're usually right, and the confidence bar shows how sure FilePlot is. But always check important details, such as amounts and due dates, against the original document.