ZotFile and Automatic PDF File Management in Zotero

ZotFile was, for most of the last decade, the standard way to get Zotero to rename incoming PDFs by author/year/title and move them out of Zotero’s internal storage folder into a normal, human-readable folder structure on disk. Zotero has since built much of that behavior in natively, and ZotFile’s own project page now says it is “currently not actively developed and maintained.” That leaves a real, practical question for anyone setting up a new Zotero library today: do you still need the plugin, or does Zotero’s built-in file renaming already cover it?

What ZotFile actually does

ZotFile is a third-party Zotero add-on, not part of Zotero itself. Its core jobs are:

• Automatic renaming of attached files using item metadata (author, year, title) as soon as a PDF is attached to a Zotero item.
• Moving files out of Zotero’s storage folder into a custom folder structure you define on disk (e.g. organized by subfolder per author or per collection), rather than leaving every attachment buried in Zotero’s internal storage/ directory.
• Sending files to a tablet or reading folder and re-importing any annotations made outside Zotero — a workflow built for the era before Zotero had its own built-in PDF reader.

All three of those jobs assumed Zotero itself would do very little file management on its own. That assumption is no longer accurate.

What changed: Zotero’s own file renaming

Zotero has always renamed some attached files automatically, but Zotero 7 (2024) substantially expanded that capability with a customizable renaming template system, documented directly by the Zotero project. The setting lives in Zotero’s General preferences pane as “Automatically rename attachment files using parent metadata” (labeled “Automatically rename files” in Zotero 8). By default it produces filenames like:

Lee et al. - 2023 - The First Room-Temperature Ambient-Pressure Superconductor.pdf

using a template of the form {{ firstCreator suffix=" - " }}{{ year suffix=" - " }}{{ title truncate="100" }}. Beyond the default, Zotero 7+ supports a real templating syntax with placeholders for creators, editors, year, title, DOI, and ISBN, plus parameters for truncation, case conversion (upper/lower/snake_case), initials, custom separators, and regex replacement — including conditional templates that vary by item type, e.g. using the ISBN for a book but the DOI for a preprint.

That native renaming, on its own, covers the first of ZotFile’s three jobs — automatic, metadata-driven filenames — for most users without installing anything.

What native Zotero still doesn’t do

Native file renaming is not the same as ZotFile’s folder-restructuring behavior. Zotero’s built-in renaming changes the filename; it does not move the file out of Zotero’s own storage directory into an independent, browsable folder tree organized however you want (by author, by project, by year). If your workflow depends on being able to open a plain OS file browser — outside Zotero entirely — and find PDFs sorted into a folder structure you designed, that specific capability is still ZotFile’s job, not Zotero’s. Native linked-attachment support (pointing Zotero at files that live in a folder you manage yourself, rather than importing a copy into Zotero’s storage) is the closer built-in equivalent, but it changes how syncing and storage quota work and is a different setup decision, not a drop-in replacement for ZotFile’s automated move-and-rename step.

The “send to tablet, re-import annotations” workflow is the part most likely to be genuinely obsolete now: Zotero’s built-in PDF reader supports highlighting, underlining, sticky notes, and freehand drawing directly inside Zotero, with those annotations extractable into notes without ever leaving the app or an external tablet app.

Should you install ZotFile in 2026?

• Skip it if all you want is metadata-driven filenames (author/year/title) — Zotero’s native renaming already does this, is actively maintained, and won’t break on a future Zotero update the way an unmaintained plugin risks doing.
• Consider it only if your workflow specifically requires files to live outside Zotero’s storage folder in a folder structure you control, and you’ve already tried native linked attachments and found them insufficient for your case.
• Be aware of the maintenance risk either way: ZotFile’s own repository states it “is currently not actively developed and maintained,” with rare updates and little response to reported issues — a real consideration before building a workflow around it, since a future Zotero update could break compatibility with no guarantee of a fix.

Setting up native automatic renaming (no plugin required)

1. Open Zotero’s Settings/Preferences, go to the General pane, and enable “Automatically rename attachment files using parent metadata.”
2. Use the default template, or open the renaming-rules editor to write your own using the placeholder syntax (creators, editors, year, title, DOI, ISBN) with truncation, case, and separator options.
3. For item-type-specific rules — for example, using a book’s ISBN but a preprint’s DOI in the filename — write a conditional template rather than a single flat pattern.
4. Test on a small batch of items first: renaming is driven entirely by your Zotero metadata, so a sparsely-filled item (missing author or year) produces a correspondingly sparse filename.

If you’re migrating away from ZotFile

Existing files that ZotFile already renamed and moved will not be retroactively reorganized by turning on native renaming — native renaming only applies going forward, to newly attached files (or on manual re-run, depending on your Zotero version). If you’re consolidating an existing library that has years of ZotFile-managed files scattered across a custom folder tree, treat that as a separate one-time cleanup task rather than expecting the native setting to reach back and fix historical files.

Frequently asked questions

Does ZotFile still work with current versions of Zotero?

ZotFile’s own project page describes it as not actively developed or maintained, with no stated compatibility guarantee for the current Zotero major version. Treat it as a legacy plugin: it may continue to work, but there’s no active maintainer confirming or fixing compatibility as Zotero itself changes.

Does Zotero rename files automatically without any plugin?

Yes. Zotero has always done some automatic renaming, and Zotero 7 and later expose a full customizable renaming-template system in the General preferences pane, covering the metadata-driven-filename job that ZotFile was most commonly used for.

Can native Zotero move files to a custom folder outside its storage directory the way ZotFile does?

Not in the same automated way. Native renaming changes filenames inside Zotero’s storage model; moving files to an independently organized folder structure on disk is the one job that still most closely matches what ZotFile was built for, typically alongside Zotero’s linked-attachment feature rather than through renaming alone.

Will turning on native file renaming reorganize files ZotFile already moved?

No. Native renaming applies to files as they’re attached or renamed going forward; it doesn’t retroactively rewrite a folder structure ZotFile already built. Migrating a large existing ZotFile-managed library is a separate cleanup step.

Related reading

• Zotero for Researchers: Reference and Citation Management Guide — collections, tags, group libraries, and the word-processor citation plugin.
• Zotero Setup and Troubleshooting: Connector, Word Plugin, and Sync — for install/repair issues unrelated to file renaming.
• Taking and Exporting Notes in Zotero — for the native PDF-annotation-to-note workflow that has reduced the need for a tablet-based annotation round trip.
• Best Zotero AI Plugins: Beaver, PapersGPT, ARIA, and ZotAI Compared — for how other Zotero add-ons install and what data they handle.
• Research Tools & Software — the full research-tools hub.