Every file on your computer has a name. Most of those names are useless: scan0042.pdf, IMG_4321.HEIC, Document (3).docx, Screenshot 2026-04-22 at 09.41.png. The only way to know what's inside is to open it. Renaming files by content changes that — an AI reads what's inside each file and generates a descriptive name based on the actual subject, not a timestamp or a counter.
This guide covers exactly how it works, which file types can be renamed by content, how to set it up on Mac or Windows, and the right templates for different document types.
Quick answer: Renaming files by content means AI reads the text, image, or data inside your file and names it based on what it finds — not the existing filename or metadata. A scanned invoice becomes 2026-03-10_invoice_aws_$284.50.pdf. A photo of the California coast becomes 2026-04-12_big-sur_sunset.HEIC. This guide shows you how.
Content renaming vs rule-based renaming vs metadata renaming
Before getting into the how, it's worth being clear on what "rename by content" actually means compared to the other approaches:
| Approach | How it works | Best for | Can't handle |
|---|---|---|---|
| Rule-based | Find/replace, add prefix, strip characters — manipulates the existing filename | Fixing typos, adding consistent prefixes, numbering a sequence | Files with no useful existing name (scan0042.pdf) |
| Metadata-based | Reads EXIF fields (date, camera, GPS) embedded in the file | Photos from a camera or phone with EXIF data | Scanned documents, screenshots, PDFs — these have no useful metadata |
| Content-based (AI) | AI reads the text, image, or data inside the file | Any file regardless of its current name or metadata | Encrypted files, heavily compressed images with no recognizable subjects |
Content-based renaming is the only approach that works on files with no useful existing name and no embedded metadata — which describes the majority of scanned documents, downloaded invoices, and exported screenshots.
How AI reads different file types
The mechanics depend on the file type. FilesDesk uses three different extraction methods:
Text PDFs
For PDFs with a real text layer (most downloaded invoices, contracts, and exported reports), the text is extracted directly — fast, accurate, and no OCR needed. The AI receives the actual text content and names the file accordingly.
Input: invoice-final-FINAL.pdf (text PDF, contains Stripe invoice data) Output: 2026-03-10_invoice_stripe_$1200.00.pdf
Scanned PDFs and images
For scanned documents, photos of receipts, and any image where the content is visual, FilesDesk runs OCR first to extract text, then passes the result to AI for naming. This handles receipts photographed on a desk, contracts scanned as JPGs, and medical documents from a flatbed scanner.
Input: scan0042.pdf (scanned receipt, no text layer) Output: 2026-04-05_receipt_apple-store_$1999.pdf
Images with visual subjects
For photos, screenshots, and graphics where the meaning is purely visual (not text), FilesDesk uses AI vision — the model looks at the image and describes what it sees. For photos, EXIF date and GPS data are combined with the visual description for the richest possible name.
Input: IMG_4321.HEIC → 2026-04-12_big-sur_coastline_sunset.HEIC Input: Screenshot 2026... → 2026-04-22_stripe-dashboard-mrr-chart.png Input: photo (3).jpg → 2026-04-12_big-sur_portrait-emma.jpg
Word documents and text files
DOCX, TXT, and Markdown files are parsed for their text content. The AI identifies the document type (report, proposal, notes, article), the subject, and any key identifiers like client name or date mentioned in the body.
Input: Document (3).docx → 2026-05-01_proposal_acme-corp_website-redesign.docx Input: notes.txt → 2026-04-18_meeting-notes_q2-planning-session.txt
Step-by-step: rename files by content with FilesDesk
Step 1: Install FilesDesk
Download FilesDesk for Mac or Windows. On Mac, drag to Applications. On Windows, run the installer. Apple Silicon and Intel both supported; Windows 10/11 supported.
Step 2: Choose your AI mode
Three options, all of which can rename files by content:
- Managed: Built-in AI with credits. No API key needed — the fastest way to try content renaming. 15 free credits included.
- BYOK (Bring Your Own Key): Your OpenAI, Claude, or Gemini API key. File content goes directly from your device to the provider — no FilesDesk server in the loop. Best for high-volume use or strict data policies.
- Offline (Ollama): A local model like
qwen2.5vlrunning on your machine. Nothing leaves your computer. Best for sensitive documents.
Step 3: Drop files or a folder
Drag a folder of files into FilesDesk — a Downloads backlog, a scanner output folder, a camera dump, or a mix of everything. The app queues them for analysis.
Step 4: Pick a naming template
Templates tell the AI what format to use for the output name. FilesDesk ships with presets for the most common use cases, and you can write your own.
| File type | Template | Example output |
|---|---|---|
| Invoice / receipt | {date}_{type}_{vendor}_{amount} | 2026-03-10_invoice_aws_$284.pdf |
| Contract / legal | {date}_{type}_{counterparty}_{subject} | 2026-02-15_contract_acme_sow.pdf |
| Photo | {exif_date}_{location}_{subject} | 2026-04-12_big-sur_sunset.HEIC |
| Screenshot | {date}_{subject} | 2026-04-22_stripe-mrr-dashboard.png |
| Document / report | {date}_{type}_{client}_{title} | 2026-05-01_proposal_acme_web-redesign.docx |
| General / mixed | AI Smart Rename (auto-detect type) | Picks the right format per file |
Step 5: Preview before applying
FilesDesk shows you the proposed new name for every file before it changes anything. Review the list, edit any names you want to adjust, and only then apply. Nothing is renamed without your sign-off.
Step 6: Apply — and undo if needed
Click Apply. Every rename is logged. If something looks wrong after the fact, one click reverts the entire batch.
Tip — custom prompts for specific document types: For medical records, legal filings, or any specialized document type, write a custom prompt: "This is a medical lab report. Extract: patient name, test type, date, and lab name. Format as: {date}_{test-type}_{lab}_{patient-surname}." Custom prompts give you complete control over what the AI extracts and how it formats the result.
Rename by content for specific file types
Rename PDFs by content
PDFs are the most common case. Whether it's a text PDF (invoices, contracts, reports) or a scanned PDF (receipts, forms, signed documents), FilesDesk handles both. For scanned PDFs, OCR runs first. See also: full guide to renaming PDFs by content on Mac.
Rename photos by content
For photos, content renaming combines two sources: EXIF metadata (date taken, GPS coordinates, camera model) and AI vision (what the photo depicts). The result is names like 2026-04-12_kyoto_fushimi-inari-shrine_golden-hour.HEIC — findable by location, subject, and date without opening the photo. See also: EXIF photo renaming guide.
Rename Word documents by content
DOCX files exported from Word, Pages, or Google Docs often get saved with generic names. Content renaming reads the document body, identifies the type and subject, and names it accordingly. See also: renaming Word documents by content on Mac.
Rename screenshots by content
Screenshots are the hardest case for rule-based tools — they have a timestamp name and no meaningful metadata. AI vision reads the screen content (app UI, chart, error message, conversation) and generates a descriptive name. A screenshot of a Stripe revenue chart becomes 2026-04-22_stripe-dashboard-mrr-chart.png, findable six months later without opening it.
Automating content-based renaming with Watch Folders
Batch-cleaning an existing pile is a one-time job. The bigger win is making sure new files never pile up with bad names in the first place.
FilesDesk's Watch Folder feature monitors any folder you choose. When a new file appears, it's automatically read by AI, renamed by content, and optionally moved to a destination folder — all without you touching it.
# Typical Watch Folder setup
~/Downloads → rename by content, move to ~/Documents/{type}/
~/Desktop → rename by content, keep in place
~/Pictures/Scans → rename by content (OCR), move to ~/Documents/Finance/Combined with a folder structure, Watch Folders turn content-based renaming from a cleanup task into a permanent system. See the full Watch Folders guide.
Privacy: what happens to your file contents
Renaming by content means the AI sees inside your files. For sensitive documents — tax returns, medical records, legal contracts — this matters. FilesDesk gives you full control:
- Offline mode (Ollama): The model runs locally. Zero bytes leave your machine. Slower but completely private.
- BYOK mode: Content goes directly to your OpenAI, Claude, or Gemini account — not through FilesDesk servers. You're subject to your provider's data policy, which you already agreed to.
- Managed mode: Content is encrypted in transit to FilesDesk's processing service and deleted after the rename is generated. Not stored, not trained on.
Try content-based renaming free
15 AI credits included. No card. Mac & Windows. Apple Silicon native.
Download FilesDeskFAQ
What does it mean to rename files by content?
It means the tool opens each file, reads what's inside (text, image, data), and uses that information to generate a meaningful filename. This is fundamentally different from rule-based renaming, which only manipulates the existing filename without reading the file, and metadata renaming, which uses embedded fields like EXIF date or camera model.
Can I rename scanned PDFs by content?
Yes. FilesDesk runs OCR on scanned PDFs before sending the extracted text to AI for naming. Even a photo of a crumpled receipt or a low-resolution scanner output gets a meaningful name — vendor, date, amount, document type — as long as the scan is legible enough for OCR to extract the key fields.
What file types can be renamed by content?
PDFs (text and scanned), images (JPG, PNG, HEIC, WEBP, GIF), Word documents (DOCX), text files (TXT, MD), and spreadsheets (XLSX, CSV). Over 30 file types in total. For a full list, see the docs.
Is renaming files by content private?
It depends on the mode you choose. In Offline mode (Ollama), nothing leaves your machine. In BYOK mode, content goes directly to your AI provider account with no FilesDesk server involved. In Managed mode, files are encrypted in transit and deleted after processing — never stored or used for training.
How is renaming by content different from renaming by metadata?
Metadata renaming (EXIF, creation date, file type) reads fields already attached to the file without opening it. Content renaming reads inside the file and understands the subject matter. For camera photos, metadata is great because EXIF is rich. For scanned documents, downloaded invoices, or screenshots, there's no useful metadata — content renaming is the only option.
Can I rename files by content on Windows?
Yes. FilesDesk runs natively on Windows 10 and 11. The workflow — drop files, choose template, preview, apply — is identical to the Mac version. See also: best AI file renamer for Windows.