Paperless-ngx 3.2.0 landed on September 19, 2026, and it’s a bigger release than the version number suggests. Where 3.1.0 (out August 27) focused on AI-assisted workflow actions and document versioning, this update goes after something more fundamental for anyone running the tool at scale: how you actually find the document you’re looking for. The release is tagged and signed on GitHub as v3.2.0, credited to maintainer @shamoon.
If you’re new here: Paperless-ngx is the self-hosted document management system a lot of the homelab community relies on to scan, OCR, tag, and archive paperwork instead of letting it pile up in a drawer or a shoebox. We cover the project in depth on our Paperless-ngx product page, and wrote about the previous release in Paperless-ngx 3.1.0 Adds AI Workflow Actions and Document Versioning.
What’s new in 3.2.0
The headline feature is a reworked approach to share links, the temporary, revocable URLs you hand out when someone outside your instance needs to see a document without a login. Earlier versions handled these one at a time. 3.2.0 adds centralized management for share links plus the ability to group them into bundles, so you can hand over ten documents from one project as a single link instead of ten separate ones.
Beyond that, this release brings:
- Sidebar items you can now hide, useful if you don’t use every panel and want a cleaner interface
- A configurable timeout for custom regex rules, so a poorly written pattern can’t hang a consumption job indefinitely
- A duplicates filter, for catching documents that got scanned twice
- The ability to deselect individual items from a “select all” action instead of starting over
- Externally configured options (environment variables) now show up in the Config UI, so you can check what’s actually set without SSHing in to read your .env file
- An option to turn off auto-suggestions specifically for documents sitting in the inbox
The search and matching changes are the real story
If I had to pick one part of this release to pay attention to, it’s the search overhaul. Paperless-ngx’s advanced query search used to rely on a hand-written translation layer to convert search syntax into something the Whoosh search engine could execute. 3.2.0 replaces that with native fuzzy term matching inside the parsed query itself, so a typo in a search term is more likely to still surface the right document, and the logic lines up with how Whoosh actually works instead of fighting a bolted-on translator.
There’s also new support for matching CJK terms (Chinese, Japanese, and Korean) through their bigram fields, which matters if you’re archiving documents in those languages and have been getting inconsistent results.
On the automatic matching side (the logic that assigns correspondents, storage paths, and tags without you lifting a finger), the maintainers removed an existing bias in the matching algorithm and added a minimum match threshold. In plain terms: fewer confident-but-wrong auto-tags. There’s also a new Tantivy-based full-text fallback adapter for taxonomy candidate matching, a fairly deep change for something most users will only notice as “tagging got a bit more accurate.”
Bug fixes and dependency updates
3.2.0 isn’t just new features. The changelog lists fixes for the PDF editor interface, parent/child tag handling during bulk edits, orphaned document versions left behind after a bulk delete, email subjects getting truncated at the field’s max length, and some API permission inconsistencies. There are also 29 dependency updates bundled in: routine maintenance, but worth knowing about if you like to track what changed under the hood.
How this compares to 3.1.0
3.1.0, released in late August, was mostly about AI-assisted workflow actions and document versioning. That was a fairly big, forward-looking release in its own right. 3.2.0 is different in character: it’s a search-and-matching-focused release with a healthy pile of quality-of-life fixes on top. Less flashy, more about making daily use of an instance with thousands of documents feel less like fighting the search bar.
How to update
As always with Paperless-ngx, the update path depends on how you deployed it. For the common Docker Compose setup:
docker compose pull docker compose up -d
Check the release notes for any migration steps before pulling if you’re several versions behind. 3.2.0 doesn’t appear to require anything unusual, but it’s worth a quick read of the full changelog before you update a production instance.
Full details, including the complete list of fixes, are in the official v3.2.0 release notes on GitHub.