# Paperless-ngx v3.1.0 — Paperless-ngx v3.1.0

- Product: Paperless-ngx (https://whatsnew.fyi/product/paperless-ngx)
- Vendor: Paperless-ngx
- Date: 2026-08-27
- Version: v3.1.0
- Original notes: https://github.com/paperless-ngx/paperless-ngx/releases/tag/v3.1.0
- Permalink: https://whatsnew.fyi/product/paperless-ngx/releases/v3.1.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Apply AI suggestions workflow action
- **added** — Support using remote OCR engines selectively
- **added** — Websocket heartbeat
- **added** — Sync OIDC groups to superuser and staff roles
- **added** — Merge documents as versions
- **added** — Allow selection of compression type and level during export
- **added** — Customizable icons for saved views
- **added** — Add --url argument to document_fuzzy_match to improve output
- **added** — Updates remote OCR parser to respect the OCR mode setting
- **changed** — Apply visual tweaks to welcome widget
- **changed** — Better support long list of views in documents list
- **changed** — Add count badge to versions dropdown
- **changed** — Add jitter to IMAP polling schedule
- **changed** — Render paperless_ai prompts via Jinja2 templates instead of f-strings
- **changed** — Prefer existing tags, types, correspondents, and storage paths in AI suggestions
- **changed** — Reduce memory and I/O overhead of the document exporter during zip exports
- **changed** — More efficient mail fetching
- **fixed** — Prevent config autocomplete craziness
- **fixed** — Prevent token re-use in dropdown filtering
- **fixed** — Exclude version documents from bulk edit all

##### paperless-ngx 3.1.0

###### Features / Enhancements

- Enhancement: Apply AI suggestions workflow action @shamoon ([#13639](https://github.com/paperless-ngx/paperless-ngx/pull/13639))
- Enhancement: welcome widget visual tweaks @shamoon ([#13794](https://github.com/paperless-ngx/paperless-ngx/pull/13794))
- Enhancement: support using remote OCR engines selectively @shamoon ([#13633](https://github.com/paperless-ngx/paperless-ngx/pull/13633))
- Enhancement: websocket heartbeat @oktupol ([#13739](https://github.com/paperless-ngx/paperless-ngx/pull/13739))
- Enhancement: more v3 ui tweaks @shamoon ([#13774](https://github.com/paperless-ngx/paperless-ngx/pull/13774))
- Tweak: better support long list of views in documents list @shamoon ([#13769](https://github.com/paperless-ngx/paperless-ngx/pull/13769))
- QoL: add count badge to versions dropdown @shamoon ([#13753](https://github.com/paperless-ngx/paperless-ngx/pull/13753))
- Tweakhancement: add jitter to IMAP polling schedule @shamoon ([#13734](https://github.com/paperless-ngx/paperless-ngx/pull/13734))
- Enhancement: sync OIDC groups to superuser and staff roles @BeSovereign ([#13060](https://github.com/paperless-ngx/paperless-ngx/pull/13060))
- Enhancement: merge documents as versions @shamoon ([#13515](https://github.com/paperless-ngx/paperless-ngx/pull/13515))
- Tweak: adjust modal proportions for small screens @shamoon ([#13728](https://github.com/paperless-ngx/paperless-ngx/pull/13728))
- Refactor: render paperless\_ai prompts via Jinja2 templates instead of f-strings @stumpylog ([#13698](https://github.com/paperless-ngx/paperless-ngx/pull/13698))
- Tweak: small visual tweaks / improvements \& fixes @shamoon ([#13700](https://github.com/paperless-ngx/paperless-ngx/pull/13700))
- Enhancement: prefer existing tags, types, correspondents, and storage paths in AI suggestions @stumpylog ([#13676](https://github.com/paperless-ngx/paperless-ngx/pull/13676))
- Tweak: tweak permissions menu labels for shared user-dependent views @shamoon ([#13685](https://github.com/paperless-ngx/paperless-ngx/pull/13685))
- Feature: Allow selection of compression type and and level during export @stumpylog ([#13661](https://github.com/paperless-ngx/paperless-ngx/pull/13661))
- Enhancement: customizable icons for saved views @shamoon ([#13388](https://github.com/paperless-ngx/paperless-ngx/pull/13388))
- Enhancement: Add --url argument to document\_fuzzy\_match to improve output @lukyjay ([#13123](https://github.com/paperless-ngx/paperless-ngx/pull/13123))
- Feature: Updates remote OCR parser to respect the OCR mode setting @stumpylog ([#13408](https://github.com/paperless-ngx/paperless-ngx/pull/13408))
- Tweak: improve no ML suggestions UX @shamoon ([#13621](https://github.com/paperless-ngx/paperless-ngx/pull/13621))
- Performance: reduce memory and I/O overhead of the document exporter during zip exports @stumpylog ([#13490](https://github.com/paperless-ngx/paperless-ngx/pull/13490))
- QoL: make name button text on attribute pages selectable @shamoon ([#13592](https://github.com/paperless-ngx/paperless-ngx/pull/13592))
- Performance: More efficient mail fetching @stumpylog ([#13432](https://github.com/paperless-ngx/paperless-ngx/pull/13432))

###### Bug Fixes

- Fix: prevent config autocomplete craziness @shamoon ([#13808](https://github.com/paperless-ngx/paperless-ngx/pull/13808))
- Fix/performance: prevent token re-use in dropdown filtering, also a perf thing @shamoon ([#13804](https://github.com/paperless-ngx/paperless-ngx/pull/13804))
- Fix: exclude version documents from bulk edit "all" @shamoon ([#13791](https://github.com/paperless-ngx/paperless-ngx/pull/13791))
- Fix: fix bottom mobile nav buttons on Android @shamoon ([#13780](https://github.com/paperless-ngx/paperless-ngx/pull/13780))
- Fix: lazy import guardian modules to fix search language setting @shamoon ([#13768](https://github.com/paperless-ngx/paperless-ngx/pull/13768))
- Fix: version indexing fixes @shamoon ([#13737](https

_[Truncated at 4000 characters — full notes: https://github.com/paperless-ngx/paperless-ngx/releases/tag/v3.1.0]_