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.

  1. Open FilePlot. The first screen offers Import Documents and Try Samples.
  2. 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.
  3. Import your own files. FilePlot reads each one and shows the result in Documents.
  4. Check anything marked "Needs review". The Dashboard lists these under Waiting for you.
Your originals are safe. FilePlot works on its own copy of each file. The file you imported is never changed, renamed or moved.

Finding your way around

SectionWhat it's for
DashboardYour library at a glance, documents waiting for review, and recent imports
DocumentsEvery document, with filters by type, status and language
CategoriesYour folders for organising the library
SearchSearch across names, text, details and tags
WorkflowsSteps FilePlot repeats for you
LanguagesWhich languages FilePlot can read on this device
Local AI ModelsOn-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

KindFormats
PDFDigital and scanned PDFs, including password-protected ones
ImagesJPEG, PNG, HEIC, TIFF
OfficeWord (.docx), Excel (.xlsx), PowerPoint (.pptx)
OpenDocument.odt, .ods, .odp
Text and dataText, Markdown, RTF, HTML, CSV, JSON, XML, source code
Other filesKept 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.

TabShows
OverviewThe suggested name, document type and confidence, summary, tags and similar documents
DetailsDates, amounts, invoice and reference numbers, IBANs, tax numbers, companies, people, addresses, emails, phone numbers and websites
TextThe text of each page, with its language and, for scans, how clearly it was read
LanguagesEvery language in the document, how much of it each takes up, and which page is in which language
HistoryEach 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

StatusMeaning
ReadyEverything worked
ProcessingFilePlot is still reading it
Needs reviewSomething is uncertain, such as a faint scan or an unclear document type
FailedThe document couldn't be read. History explains why
Out of dateYou 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.

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.
Summaries are a guide, not advice. Summaries of contracts and legal documents aren't legal advice, and summaries of medical documents aren't a diagnosis. Always check the original document for anything important.

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

KeysAction
⌘OImport documents
⌘RReprocess the selected documents
⌘.Stop the current batch
⌘1 to ⌘7Go to a section
⌥⌘IShow 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.