Release notes from paperless-ngx

Paperless-ngx v3.2.1

2026-09-20T21:57:40Z

paperless-ngx 3.2.1

Bug Fixes

Fix: only pass --conf to flower when flowerconfig.py exists @bitfoo1 (#14182)
Fix: replace stale mail-fetch overlap check with a self-expiring lock @stumpylog (#14189)
Fix: bump ocrmypdf to 17.12 to pick up the ligature text-layer fix @stumpylog (#14190)
Fix: rebuild the search index automatically when it is missing Tantivy files @stumpylog (#14180)

Dependencies

Chore(deps): Bump anyio from 4.12.1 to 4.14.2 in the uv group across 1 directory @dependabot[bot] (#14175)

All App Changes

4 changes

Chore(deps): Bump anyio from 4.12.1 to 4.14.2 in the uv group across 1 directory @dependabot[bot] (#14175)
Fix: replace stale mail-fetch overlap check with a self-expiring lock @stumpylog (#14189)
Fix: bump ocrmypdf to 17.12 to pick up the ligature text-layer fix @stumpylog (#14190)
Fix: rebuild the search index automatically when it is missing Tantivy files @stumpylog (#14180)

Paperless-ngx v3.2.0

2026-09-19T03:05:49Z

paperless-ngx 3.2.0

Features / Enhancements

Enhancement (QoL): support deselecting single items from "select all" @shamoon (#14117)
Enhancement: Match fuzzy terms in place inside the parsed query @stumpylog (#14157)
Enhancement: Match CJK terms through their bigram fields in place @stumpylog (#14156)
Enhancement: centralized management of share links + bundles @shamoon (#14115)
Enhancement: parse advanced search with whoosh-compat and delete the handwritten translation @stumpylog (#14072)
Enhancement: allow regex timeout configuration @shamoon (#14085)
Enhancement: hide-able sidebar items @shamoon (#14052)
Enhancement: Improve matching for correspondents, storage path and labels by removing bias + adding minimum match threshold @dewey (#12164)
Enhancement: add Tantivy full-text fallback adapter for taxonomy candidates @stumpylog (#13820)
Enhancement (QoL): surface externally-set options in Config UI @shamoon (#13989)
Enhancement: allow disabling auto-suggestions for inbox documents @shamoon (#13946)
Change: skip documents with empty content in apply AI suggestions WF @shamoon (#13985)
Enhancement: duplicates filter @shamoon (#13994)
Tweak: note that apply AI suggestions runs async in WF editor @shamoon (#14004)
Enhancement (QoL): attempt to localize firstDayOfWeek for date picker @shamoon (#13999)

Bug Fixes

Fix: don't redirect to signup on first install when regular login is disabled @cyberb (#14165)
Fix: better catch email workflow placeholder parsing errors @shamoon (#14129)
Fix: validate legacy bulk edit owner, rotate and split parameters @stumpylog (#14120)
Fix: validate set_permissions with a nested serializer @stumpylog (#14119)
Fix: Use prefetching to reduce query counts during classifier training @stumpylog (#14122)
Fix: reject non-dict user_args/barcode_tag_mapping in config API @stumpylog (#14118)
Fix: type edit_pdf operations via a nested serializer @stumpylog (#14116)
Fix: ensure django setup is run for management comments under 3.14 @shamoon (#14100)
Fix: validate PDF output doc indexes in bulk edit @shamoon (#14083)
Fix: avoid IntegrityError when a retried task republishes with the same ID @stumpylog (#14096)
Fix: update some api global perms inconsistencies @shamoon (#14086)
Fix: ignore nested action IDs on WF create @shamoon (#14084)
Fix: correct text/stream compression workaround @shamoon (#14064)
Fix: ui version content switching inconsistencies @shamoon (#14066)
Fix: prevent saving changes to stale cached document object @shamoon (#14065)
Fix: ensure remove inbox tag children on remove_inbox_tags @shamoon (#14050)
Fix: connect add_to_index handler after document_added @shamoon (#14058)
Fix: Drop empty files from tracking after the stability window has passed @stumpylog (#14047)
Fixhancement: better LLM errors @shamoon (#14031)
Fix: prevent orphaned versions from bulk delete @shamoon (#14030)
Fixhancement: prevent overlapping mail-account processing runs @stumpylog (#14046)
Fix: Use PAPERLESS_REDIS_PREFIX for Celery result backend keys @bdd (#14015)
Fix: correct setting ai_enabled to false via UI @shamoon (#13987)
Fix: catch some frontend failed object retrievals @shamoon (#14023)
Fix: more v3 icons cleanup @shamoon (#14017)
Fix: correct add version actor parity @shamoon (#14016)
Fix: fix v3 favicon file @shamoon (#14014)
Fix: change share link bundle dialog button to close after create, don't toast on copied @shamoon (#14002)
Fix: truncate mail subjects to field max length @shamoon (#13991)
Fix: enforce the overflow hidden rule on pdf editor thumbnails @shamoon (#13976)
Fix: also correct unbroken long names on small cards @shamoon (#13974)
Fix: ensure parent + child tags change together in bulk editor @shamoon (#13972)

Dependencies

29 changes

Chore(deps): Bump the utilities-patch group across 1 directory with 15 updates @dependabot[bot] (#14167)
docker(deps): Bump astral-sh/uv from 0.12.9-python3.14-trixie-slim to 0.12.16-python3.14-trixie-slim @dependabot[bot] (#14134)
Chore(deps): Bump the utilities-minor group across 1 directory with 10 updates @dependabot[bot] (#14149)
Chore(deps): Bump the actions group across 1 directory with 8 updates @dependabot[bot] (#14162)
Chore(deps): Bump the frontend-angular-dependencies group across 1 directory with 19 updates @dependabot[bot] (#14141)
docker-compose(deps): bump gotenberg/gotenberg from 8.36 to 8.37 in /docker/compose @dependabot[bot] (#14137)
docker-compose(deps): Bump nginx from 1.31.5-alpine to 1.31.6-alpine in /docker/compose @dependabot[bot] (#14138)
Chore(deps): Bump pdfjs-dist from 6.2.108 to 6.3.289 in /src-ui @dependabot[bot] (#14144)
Chore(deps-dev): Bump the frontend-eslint-dependencies group across 1 directory with 4 updates @dependabot[bot] (#14143)
Chore(deps-dev): Bump @types/node from 26.4.0 to 26.5.0 in /src-ui @dependabot[bot] (#14146)
Chore(deps-dev): Bump the frontend-jest-dependencies group across 1 directory with 2 updates @dependabot[bot] (#14142)
Chore(deps): Bump the utilities-minor group across 1 directory with 11 updates @dependabot[bot] (#13988)
Chore(deps): Bump sentence-transformers from 5.6.1 to 6.0.0 @dependabot[bot] (#13983)
Chore(deps-dev): Bump types-markdown from 3.10.2.20260518 to 3.10.2.20260712 @dependabot[bot] (#13982)
Chore(deps): Bump the utilities-patch group across 1 directory with 6 updates @dependabot[bot] (#13980)
Chore(deps): Update granian[uvloop] requirement from ~=2.7.0 to >=2.7,<2.9 @dependabot[bot] (#13984)
Chore: Updates our direct Redis pin @stumpylog (#13986)
Chore(deps-dev): Bump the frontend-eslint-dependencies group across 1 directory with 4 updates @dependabot[bot] (#13918)
Chore(deps): Bump uuid from 14.0.1 to 14.0.2 in /src-ui @dependabot[bot] (#13921)
Chore(deps-dev): Bump @types/node from 26.2.0 to 26.4.0 in /src-ui @dependabot[bot] (#13919)
Chore: update ng-select to v24, handle breaking changes @shamoon (#13951)
Chore(deps): Bump djangorestframework from 3.17.2 to 3.18.0 in the django-ecosystem group across 1 directory @dependabot[bot] (#13912)
Chore(deps): Bump the pre-commit-dependencies group across 1 directory with 3 updates @dependabot[bot] (#13922)
Chore(deps): Bump the document-processing group across 1 directory with 4 updates @dependabot[bot] (#13916)
Chore(deps): Bump flower from 2.0.1 to 2.1.0 in the async-tasks group across 1 directory @dependabot[bot] (#13913)
Chore(deps): Bump the actions group across 1 directory with 15 updates @dependabot[bot] (#13920)
docker-compose(deps): Bump gotenberg/gotenberg from 8.34 to 8.36 in /docker/compose @dependabot[bot] (#13910)
Chore(deps-dev): Bump the development group across 1 directory with 2 updates @dependabot[bot] (#13911)
docker(deps): Bump astral-sh/uv from 0.12.5-python3.14-trixie-slim to 0.12.9-python3.14-trixie-slim @dependabot[bot] (#13914)

All App Changes

80 changes

Chore(deps): Bump the utilities-patch group across 1 directory with 15 updates @dependabot[bot] (#14167)
Fix: don't redirect to signup on first install when regular login is disabled @cyberb (#14165)
Chore(deps): Bump the utilities-minor group across 1 directory with 10 updates @dependabot[bot] (#14149)
Enhancement (QoL): support deselecting single items from "select all" @shamoon (#14117)
Chore(deps): Bump the frontend-angular-dependencies group across 1 directory with 19 updates @dependabot[bot] (#14141)
Enhancement: Match fuzzy terms in place inside the parsed query @stumpylog (#14157)
Enhancement: Match CJK terms through their bigram fields in place @stumpylog (#14156)
Chore(deps): Bump pdfjs-dist from 6.2.108 to 6.3.289 in /src-ui @dependabot[bot] (#14144)
Chore(deps-dev): Bump the frontend-eslint-dependencies group across 1 directory with 4 updates @dependabot[bot] (#14143)
Chore(deps-dev): Bump @types/node from 26.4.0 to 26.5.0 in /src-ui @dependabot[bot] (#14146)
Chore(deps-dev): Bump the frontend-jest-dependencies group across 1 directory with 2 updates @dependabot[bot] (#14142)
Enhancement: centralized management of share links + bundles @shamoon (#14115)
Performance: Preprocess classifier text with Tantivy instead of NLTK @stumpylog (#14127)
Performance: Drops fields from the classifier before pickling @stumpylog (#14114)
Fix: better catch email workflow placeholder parsing errors @shamoon (#14129)
Peformance: Improves the memory efficency of classifier training @stumpylog (#14124)
Performance: Streams the classifier pickle file during save as well @stumpylog (#14121)
Fix: validate legacy bulk edit owner, rotate and split parameters @stumpylog (#14120)
Fix: validate set_permissions with a nested serializer @stumpylog (#14119)
Fix: Use prefetching to reduce query counts during classifier training @stumpylog (#14122)
Fix: reject non-dict user_args/barcode_tag_mapping in config API @stumpylog (#14118)
Fix: type edit_pdf operations via a nested serializer @stumpylog (#14116)
Performance: Loads the classifier through a memory view to reduce memory usage @stumpylog (#14113)
Feature: parse advanced search with whoosh-compat and delete the handwritten translation @stumpylog (#14072)
Fix: ensure django setup is run for management comments under 3.14 @shamoon (#14100)
Fix: validate PDF output doc indexes in bulk edit @shamoon (#14083)
Enhancement: allow regex timeout configuration @shamoon (#14085)
Fix: avoid IntegrityError when a retried task republishes with the same ID @stumpylog (#14096)
Chore: include Apply AI Suggestions in the tasks UI filter dropdown @shamoon (#14093)
Fix: update some api global perms inconsistencies @shamoon (#14086)
Fix: ignore nested action IDs on WF create @shamoon (#14084)
Fix: correct text/stream compression workaround @shamoon (#14064)
Fix: ui version content switching inconsistencies @shamoon (#14066)
Fix: prevent saving changes to stale cached document object @shamoon (#14065)
Performance: batch permission assignment in bulk set_permissions @stumpylog (#13806)
Performance: skip effective_content annotation on document list unless required @stumpylog (#13789)
Fix: ensure remove inbox tag children on remove_inbox_tags @shamoon (#14050)
Fix: connect add_to_index handler after document_added @shamoon (#14058)
Enhancement: hide-able sidebar items @shamoon (#14052)
Performance: cut redundant per-document lookups in bulk modify_custom_fields @stumpylog (#13807)
Enhancement: Improve matching for correspondents, storage path and labels by removing bias + adding minimum match threshold @dewey (#12164)
Fix: Drop empty files from tracking after the stability window has passed @stumpylog (#14047)
Fixhancement: better LLM errors @shamoon (#14031)
Fix: prevent orphaned versions from bulk delete @shamoon (#14030)
Enhancement: add Tantivy full-text fallback adapter for taxonomy candidates @stumpylog (#13820)
Fixhancement: prevent overlapping mail-account processing runs @stumpylog (#14046)
Performance: ensure version-aware content filters on querysets @shamoon (#13792)
Performance: skip nested TagSerializer construction when a tag has no children @stumpylog (#14039)
Enhancement (QoL): surface externally-set options in Config UI @shamoon (#13989)
Enhancement: allow disabling auto-suggestions for inbox documents @shamoon (#13946)
Change: skip documents with empty content in apply AI suggestions WF @shamoon (#13985)
Performance: resolve index-write permissions and effective content in bulk @stumpylog (#13869)
Fix: Use PAPERLESS_REDIS_PREFIX for Celery result backend keys @bdd (#14015)
Enhancement: duplicates filter @shamoon (#13994)
Fix: correct setting ai_enabled to false via UI @shamoon (#13987)
Chore(deps): Bump the utilities-minor group across 1 directory with 11 updates @dependabot[bot] (#13988)
Fix: catch some frontend failed object retrievals @shamoon (#14023)
Fix: more v3 icons cleanup @shamoon (#14017)
Fix: correct add version actor parity @shamoon (#14016)
Fix: fix v3 favicon file @shamoon (#14014)
Tweak: note that apply AI suggestions runs async in WF editor @shamoon (#14004)
Fix: change share link bundle dialog button to close after create, don't toast on copied @shamoon (#14002)
Enhancement (QoL): attempt to localize firstDayOfWeek for date picker @shamoon (#13999)
Fix: truncate mail subjects to field max length @shamoon (#13991)
Chore(deps): Bump sentence-transformers from 5.6.1 to 6.0.0 @dependabot[bot] (#13983)
Chore(deps-dev): Bump types-markdown from 3.10.2.20260518 to 3.10.2.20260712 @dependabot[bot] (#13982)
Chore(deps): Bump the utilities-patch group across 1 directory with 6 updates @dependabot[bot] (#13980)
Chore(deps): Update granian[uvloop] requirement from ~=2.7.0 to >=2.7,<2.9 @dependabot[bot] (#13984)
Chore: Updates our direct Redis pin @stumpylog (#13986)
Fix: enforce the overflow hidden rule on pdf editor thumbnails @shamoon (#13976)
Fix: also correct unbroken long names on small cards @shamoon (#13974)
Chore(deps-dev): Bump the frontend-eslint-dependencies group across 1 directory with 4 updates @dependabot[bot] (#13918)
Chore(deps): Bump uuid from 14.0.1 to 14.0.2 in /src-ui @dependabot[bot] (#13921)
Chore(deps-dev): Bump @types/node from 26.2.0 to 26.4.0 in /src-ui @dependabot[bot] (#13919)
Chore: update ng-select to v24, handle breaking changes @shamoon (#13951)
Chore(deps): Bump djangorestframework from 3.17.2 to 3.18.0 in the django-ecosystem group across 1 directory @dependabot[bot] (#13912)
Chore(deps): Bump the document-processing group across 1 directory with 4 updates @dependabot[bot] (#13916)
Chore(deps): Bump flower from 2.0.1 to 2.1.0 in the async-tasks group across 1 directory @dependabot[bot] (#13913)
Chore(deps-dev): Bump the development group across 1 directory with 2 updates @dependabot[bot] (#13911)
Fix: ensure parent + child tags change together in bulk editor @shamoon (#13972)

Paperless-ngx v3.1.3

2026-09-04T03:19:50Z

paperless-ngx 3.1.3

Bug Fixes

Fix: use the header loading indicator on tasks page @shamoon (#13949)
Fix: fix load sidebar size animating @shamoon (#13947)
Fix: wrap long words without spaces in dropdowns @shamoon (#13945)
Fix: tweak tool calling localzation prompt @shamoon (#13943)
Fix: skip vector store document id filter for unrestricted chat users @stumpylog (#13937)
Fix: adopt the request stream when pinning an outbound host @ThomasSteinbach (#13927)
Fix: ensure apply ai suggestions always runs after document created @shamoon (#13940)
Fix: Handle failures when enqueuing files for consumption @stumpylog (#13935)
Fix: Handle Celery mail task chord errors @stumpylog (#13936)
Fix/chore: refactor some signal-backed conversion technical debt @shamoon (#13902)
Fix: fix slim sidebar saved view dragging appearance @shamoon (#13906)
Fix: use signal-backed queries input in CF dropdown to reflect changes immediately under zoneless @shamoon (#13901)
Fix: use root doc metadata for filename generation @shamoon (#13893)
Fix: some css cleanup @shamoon (#13891)

Dependencies

7 changes

Chore(deps): Bump the uv group across 1 directory with 2 updates @dependabot[bot] (#13958)
docker-compose(deps): bump nginx from 1.31.3-alpine to 1.31.5-alpine in /docker/compose @dependabot[bot] (#13909)
docker-compose(deps): Bump greenmail/standalone from 2.1.11 to 2.1.13 in /docker/compose @dependabot[bot] (#13907)
Chore(deps-dev): Bump postcss-selector-parser from 6.1.2 to 6.1.4 in /src/paperless_mail/templates in the npm_and_yarn group across 1 directory @dependabot[bot] (#13905)
Chore(deps): Bump nltk from 3.10.0 to 3.10.3 in the data-nlp-search group across 1 directory @dependabot[bot] (#13917)
Chore(deps): Bump the frontend-angular-dependencies group across 1 directory with 14 updates @dependabot[bot] (#13915)
Chore(deps): Bump djangorestframework from 3.17.1 to 3.17.2 in the uv group across 1 directory @dependabot[bot] (#13904)

All App Changes

22 changes

Chore(deps): Bump the uv group across 1 directory with 2 updates @dependabot[bot] (#13958)
Chore(deps-dev): Bump postcss-selector-parser from 6.1.2 to 6.1.4 in /src/paperless_mail/templates in the npm_and_yarn group across 1 directory @dependabot[bot] (#13905)
Chore(deps): Bump nltk from 3.10.0 to 3.10.3 in the data-nlp-search group across 1 directory @dependabot[bot] (#13917)
Fix: use the header loading indicator on tasks page @shamoon (#13949)
Chore(deps): Bump the frontend-angular-dependencies group across 1 directory with 14 updates @dependabot[bot] (#13915)
Chore(deps): Bump djangorestframework from 3.17.1 to 3.17.2 in the uv group across 1 directory @dependabot[bot] (#13904)
Fix: fix load sidebar size animating @shamoon (#13947)
Fix: wrap long words without spaces in dropdowns @shamoon (#13945)
Fix: tweak tool calling localzation prompt @shamoon (#13943)
Fix: skip vector store document id filter for unrestricted chat users @stumpylog (#13937)
Fix: adopt the request stream when pinning an outbound host @ThomasSteinbach (#13927)
Fix: ensure apply ai suggestions always runs after document created @shamoon (#13940)
Fix: Handle failures when enqueuing files for consumption @stumpylog (#13935)
Fix: Handle Celery mail task chord errors @stumpylog (#13936)
Fix/chore: refactor some signal-backed conversion technical debt @shamoon (#13902)
Security: validate remote OCR endpoint @stumpylog (#13897)
Fix: fix slim sidebar saved view dragging appearance @shamoon (#13906)
Security: Minor additional hardening @stumpylog (#13898)
Chore: consolidate pickle hmac signing @shamoon (#13899)
Fix: use signal-backed queries input in CF dropdown to reflect changes immediately under zoneless @shamoon (#13901)
Fix: use root doc metadata for filename generation @shamoon (#13893)
Fix: some css cleanup @shamoon (#13891)

Paperless-ngx v3.1.2

2026-09-01T15:29:20Z

paperless-ngx 3.1.2

Note

This release addresses a security issue (GHSA-2jhj-xqrq-rmrq) and is recommended for all users. Our sincere thank you to the community members (and their LLMs) for reporting this.

Bug Fixes

Fix: fix dark mode select disabled color, ensure disabled cursor on display mode dropdown @shamoon (#13881)
Fix: add disable to the drag-drop list component @shamoon (#13880)

Documentation

Chore: update screenshots for v3+ @shamoon (#13883)

All App Changes

2 changes

Fix: fix dark mode select disabled color, ensure disabled cursor on display mode dropdown @shamoon (#13881)
Fix: add disable to the drag-drop list component @shamoon (#13880)

Paperless-ngx v3.1.1

2026-08-31T05:55:17Z

paperless-ngx 3.1.1

Bug Fixes

Fix: 3.1.0 llm suggestions remove existing metadata from prompt, dont drop name suggestions @shamoon (#13866)
Fix: set global search earlier to avoid awaiting debounce @shamoon (#13865)
Fix: responsive sidebar, centralize and make sizes saner @shamoon (#13863)
Tweak/fix: show existing count for ai suggestions @shamoon (#13861)
Fix: 3.1.0 llm suggestions simplify schema, fix docstrings @shamoon (#13850)
Fix: ensure ui reset of suggestionsLoading when changing docs @shamoon (#13840)
Fix: always pass a non-empty api key for OpenAI-like servers @shamoon (#13838)
Fix: hide slim sidebar scrollbar in browsers with stupid scrollbars @shamoon (#13837)
Fix: correct sharelink bundle + document link permissions display bugs @shamoon (#13827)
Fix: immediately re-add doc to index after trash restore @shamoon (#13818)
Fix: navbar brand anchor size + Safari position jitter @shamoon (#13810)

All App Changes

12 changes

Fix: 3.1.0 llm suggestions remove existing metadata from prompt, dont drop name suggestions @shamoon (#13866)
Fix: set global search earlier to avoid awaiting debounce @shamoon (#13865)
Fix: responsive sidebar, centralize and make sizes saner @shamoon (#13863)
Tweak/fix: show existing count for ai suggestions @shamoon (#13861)
Fix: 3.1.0 llm suggestions simplify schema, fix docstrings @shamoon (#13850)
Fixhancement: make imap port required, better error display @shamoon (#13845)
Fix: ensure ui reset of suggestionsLoading when changing docs @shamoon (#13840)
Fix: always pass a non-empty api key for OpenAI-like servers @shamoon (#13838)
Fix: hide slim sidebar scrollbar in browsers with stupid scrollbars @shamoon (#13837)
Fix: correct sharelink bundle + document link permissions display bugs @shamoon (#13827)
Fix: immediately re-add doc to index after trash restore @shamoon (#13818)
Fix: navbar brand anchor size + Safari position jitter @shamoon (#13810)

Paperless-ngx v3.1.0

2026-08-27T01:59:27Z

paperless-ngx 3.1.0

Features / Enhancements

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

Bug Fixes

Fix: prevent config autocomplete craziness @shamoon (#13808)
Fix/performance: prevent token re-use in dropdown filtering, also a perf thing @shamoon (#13804)
Fix: exclude version documents from bulk edit "all" @shamoon (#13791)
Fix: fix bottom mobile nav buttons on Android @shamoon (#13780)
Fix: lazy import guardian modules to fix search language setting @shamoon (#13768)
Fix: version indexing fixes @shamoon (#13737)
Fix: append charset to file response for text files @shamoon (#13759)
Chore: pin Apache Tika images to 3.3.1 @shamoon (#13758)
Fix: align bulk edit object perms with document model @shamoon (#13757)
Fix: use selected version for doc detail emailing @shamoon (#13738)
Fix: hide version delete button without global perms @shamoon (#13735)
Fix: dont re-render path template when checking collisions @shamoon (#13718)
Fix: DocumentClassifierSchema bounds @shamoon (#13707)
Fix: remove shadow around attribute pages @shamoon (#13696)
Zen: correct dropdown corner radius visual defect @shamoon (#13695)
Fix: handle Android keyboard popper overlay @shamoon (#13694)
Fix: only show create when there is text, hide set values if no fields in cf bulk edit dropdown @shamoon (#13688)
Fix: reopen a fresh Tantivy index per write to prevent orphaned segment files @stumpylog (#13682)
Fix: fix validation of workflow title assignment @maxtruxa (#13659)
Fix: dont clip search dropdown on mobile @shamoon (#13675)
Fix: include sharelink bundle perms in WebUI @shamoon (#13664)
Fix: add pagination to saved views management page @shamoon (#13646)
Fix: fixes for workflow assign custom field values @shamoon (#13630)
Fix: deny deactivated users in permission filtering and auto-login @stumpylog (#13623)
Fix: check bulk mail delete permissions for the whole batch up front @stumpylog (#13620)
Fix: Allow DRF to validate the maximum API key length @stumpylog (#13614)
Fix: render PDF form values in annotation layer @shamoon (#13607)
QoL: disable name button without perms @shamoon (#13606)
Fix: prevent debounce overwrites in advanced search field, also improve Esc behavior @shamoon (#13602)
Fix: raise ParseError on remote OCR failure instead of silently continuing @stumpylog (#13574)
Fix: use selected version when creating share links @shamoon (#13571)
Fix: reject bulk edit permissions requests without the correct key @shamoon (#13563)
Fix: correctly serve app logo specified in env @shamoon (#13561)
Fix: prevent workflow passwords field type error @shamoon (#13552)
Fix: correct Firefox print regression @shamoon (#13543)
Fix: hide some saved view operations on management page without permissions @shamoon (#13542)
Fix: disable pdfjs selection rendering @shamoon (#13538)
Fix: hide sidebar drag grips with insufficient permissions @shamoon (#13536)
Fix: don't re-queue a consume-folder file that is already queued and awaiting consumption @stumpylog (#13526)
Fix: correct multi-search non-adjacent queries @shamoon (#13504)
Fix: Content-Disposition filename normalization @shamoon (#13514)
Fix: prevent duplicated text query with multiple date queries @shamoon (#13522)
Fix: crash filtering document link custom fields with an unset or unrelated field present @ggouzi (#13518)
Fix: parse unpadded yyyy-mm-dd date input regardless of locale @Se1foo (#13501)

Documentation

Documentation: clarify default OCR mode changes in v3 @shamoon (#13666)
Fix: fixes for workflow assign custom field values @shamoon (#13630)
Documentation: add wiki links for AI stuff and parser plugins @shamoon (#13626)

Maintenance

Chore(deps): Bump the actions group across 1 directory with 20 updates @dependabot[bot] (#13481)

Dependencies

23 changes

Chore: Upgrade Docker image to Python 3.14 @stumpylog (#13721)
Chore(deps): Bump the uv group across 1 directory with 2 updates @dependabot[bot] (#13709)
Chore: update, reorg some npm deps @shamoon (#13716)
Chore: update fpdf2 to 2.8.8 @shamoon (#13629)
Chore: update pnpm, add blockExoticSubdeps @shamoon (#13628)
Chore(deps): Bump h2 from 4.3.0 to 4.4.1 in the uv group across 1 directory @dependabot[bot] (#13593)
Chore(deps): Bump pdfjs-dist from 6.1.200 to 6.2.108 in /src-ui in the npm_and_yarn group across 1 directory @dependabot[bot] (#13594)
Chore(deps): Bump cryptography from 48.0.1 to 50.0.0 in the uv group across 1 directory @dependabot[bot] (#13588)
Chore(deps): Bump the utilities-patch group across 1 directory with 6 updates @dependabot[bot] (#13539)
Chore(deps): Bump the utilities-minor group across 1 directory with 20 updates @dependabot[bot] (#13535)
Chore(deps): Bump aiohttp from 3.14.1 to 3.14.3 in the uv group across 1 directory @dependabot[bot] (#13537)
Chore(deps-dev): Bump zensical from 0.0.47 to 0.0.51 in the development group across 1 directory @dependabot[bot] (#13533)
Chore(deps-dev): Bump postcss from 8.5.22 to 8.5.25 in /src/paperless_mail/templates in the npm_and_yarn group across 1 directory @dependabot[bot] (#13534)
Chore(deps): Bump the pre-commit-dependencies group across 1 directory with 4 updates @dependabot[bot] (#13532)
Chore: ruff 0.16 upgrade @stumpylog (#13531)
Chore(deps): Bump the actions group across 1 directory with 20 updates @dependabot[bot] (#13481)
docker(deps): bump astral-sh/uv from 0.11.28-python3.12-trixie-slim to 0.11.32-python3.12-trixie-slim @dependabot[bot] (#13472)
docker-compose(deps): bump nginx from 1.31.2-alpine to 1.31.3-alpine in /docker/compose @dependabot[bot] (#13470)
docker-compose(deps): Bump greenmail/standalone from 2.1.9 to 2.1.11 in /docker/compose @dependabot[bot] (#13469)
Chore(deps): Bump the frontend-angular-dependencies group across 1 directory with 18 updates @dependabot[bot] (#13476)
Chore(deps-dev): Bump @playwright/test from 1.61.1 to 1.62.0 in /src-ui @dependabot[bot] (#13480)
Chore(deps-dev): Bump the frontend-eslint-dependencies group across 1 directory with 4 updates @dependabot[bot] (#13477)
Chore(deps-dev): Bump @types/node from 26.1.0 to 26.1.1 in /src-ui @dependabot[bot] (#13479)

All App Changes

91 changes

Fix: prevent config autocomplete craziness @shamoon (#13808)
Fix/performance: prevent token re-use in dropdown filtering, also a perf thing @shamoon (#13804)
Enhancement: Apply AI suggestions workflow action @shamoon (#13639)
Fix: exclude version documents from bulk edit "all" @shamoon (#13791)
Enhancement: welcome widget visual tweaks @shamoon (#13794)
Performance: fetch note authors with prefetch instead of one query each @shamoon (#13790)
Tweak: more misc UI tweaks @shamoon (#13783)
Enhancement: support using remote OCR engines selectively @shamoon (#13633)
Fix: fix bottom mobile nav buttons on Android @shamoon (#13780)
Enhancement: websocket heartbeat @oktupol (#13739)
Fix: lazy import guardian modules to fix search language setting @shamoon (#13768)
Enhancement: more v3 ui tweaks @shamoon (#13774)
Chore: add some missing UI accessibility labels @shamoon (#13772)
Chore: refactor permission checkbox live changes @shamoon (#13771)
Tweak: better support long list of views in documents list @shamoon (#13769)
Fix: version indexing fixes @shamoon (#13737)
Fix: append charset to file response for text files @shamoon (#13759)
Fix: align bulk edit object perms with document model @shamoon (#13757)
QoL: add count badge to versions dropdown @shamoon (#13753)
Tweakhancement: add jitter to IMAP polling schedule @shamoon (#13734)
Fix: use selected version for doc detail emailing @shamoon (#13738)
Fix: hide version delete button without global perms @shamoon (#13735)
Enhancement: sync OIDC groups to superuser and staff roles @BeSovereign (#13060)
Enhancement: merge documents as versions @shamoon (#13515)
Tweak: adjust modal proportions for small screens @shamoon (#13728)
Refactor: render paperless_ai prompts via Jinja2 templates instead of f-strings @stumpylog (#13698)
Chore(deps): Bump the uv group across 1 directory with 2 updates @dependabot[bot] (#13709)
Fix: dont re-render path template when checking collisions @shamoon (#13718)
Chore: update, reorg some npm deps @shamoon (#13716)
Fix: DocumentClassifierSchema bounds @shamoon (#13707)
Tweak: small visual tweaks / improvements & fixes @shamoon (#13700)
Fix: remove shadow around attribute pages @shamoon (#13696)
Zen: correct dropdown corner radius visual defect @shamoon (#13695)
Fix: handle Android keyboard popper overlay @shamoon (#13694)
Enhancement: prefer existing tags, types, correspondents, and storage paths in AI suggestions @stumpylog (#13676)
Fix: only show create when there is text, hide set values if no fields in cf bulk edit dropdown @shamoon (#13688)
Fix: reopen a fresh Tantivy index per write to prevent orphaned segment files @stumpylog (#13682)
Tweak: tweak permissions menu labels for shared user-dependent views @shamoon (#13685)
Fix: fix validation of workflow title assignment @maxtruxa (#13659)
Feature: Allow selection of compression type and and level during export @stumpylog (#13661)
Fix: dont clip search dropdown on mobile @shamoon (#13675)
Fix: include sharelink bundle perms in WebUI @shamoon (#13664)
Enhancement: customizable icons for saved views @shamoon (#13388)
Enhancement: Add --url argument to document_fuzzy_match to improve output @lukyjay (#13123)
Feature: Updates remote OCR parser to respect the OCR mode setting @stumpylog (#13408)
Performance: pass document chat queries as a QuerySet instead of a materialized.list @stumpylog (#13638)
Fix: add pagination to saved views management page @shamoon (#13646)
Fix: fixes for workflow assign custom field values @shamoon (#13630)
Fix: deny deactivated users in permission filtering and auto-login @stumpylog (#13623)
Chore: update fpdf2 to 2.8.8 @shamoon (#13629)
Chore: update pnpm, add blockExoticSubdeps @shamoon (#13628)
Fix: check bulk mail delete permissions for the whole batch up front @stumpylog (#13620)
Tweak: improve no ML suggestions UX @shamoon (#13621)
Fix: Allow DRF to validate the maximum API key length @stumpylog (#13614)
Performance: unify permission-filtering backends, fixes Correspondent/Tag list slowness @stumpylog (#13601)
Performance: generalize permitted_document_ids into permitted_object_ids for any model @stumpylog (#13578)
Fix: render PDF form values in annotation layer @shamoon (#13607)
QoL: disable name button without perms @shamoon (#13606)
Fix: prevent debounce overwrites in advanced search field, also improve Esc behavior @shamoon (#13602)
Performance: reduce memory and I/O overhead of the document exporter during zip exports @stumpylog (#13490)
Chore(deps): Bump h2 from 4.3.0 to 4.4.1 in the uv group across 1 directory @dependabot[bot] (#13593)
Chore(deps): Bump pdfjs-dist from 6.1.200 to 6.2.108 in /src-ui in the npm_and_yarn group across 1 directory @dependabot[bot] (#13594)
QoL: make name button text on attribute pages selectable @shamoon (#13592)
Fix: raise ParseError on remote OCR failure instead of silently continuing @stumpylog (#13574)
Fix: use selected version when creating share links @shamoon (#13571)
Chore: specify AI chat refine template @shamoon (#13564)
Fix: reject bulk edit permissions requests without the correct key @shamoon (#13563)
Fix: correctly serve app logo specified in env @shamoon (#13561)
Fix: prevent workflow passwords field type error @shamoon (#13552)
Chore(deps): Bump the utilities-patch group across 1 directory with 6 updates @dependabot[bot] (#13539)
Chore(deps): Bump the utilities-minor group across 1 directory with 20 updates @dependabot[bot] (#13535)
Performance: More efficient mail fetching @stumpylog (#13432)
Performance: eliminate per-document guardian permission-check causing high CPU on document lists @stumpylog (#13505)
Fix: correct Firefox print regression @shamoon (#13543)
Fix: hide some saved view operations on management page without permissions @shamoon (#13542)
Chore(deps): Bump aiohttp from 3.14.1 to 3.14.3 in the uv group across 1 directory @dependabot[bot] (#13537)
Chore(deps-dev): Bump zensical from 0.0.47 to 0.0.51 in the development group across 1 directory @dependabot[bot] (#13533)
Fix: disable pdfjs selection rendering @shamoon (#13538)
Fix: hide sidebar drag grips with insufficient permissions @shamoon (#13536)
Chore(deps-dev): Bump postcss from 8.5.22 to 8.5.25 in /src/paperless_mail/templates in the npm_and_yarn group across 1 directory @dependabot[bot] (#13534)
Chore: ruff 0.16 upgrade @stumpylog (#13531)
Fix: don't re-queue a consume-folder file that is already queued and awaiting consumption @stumpylog (#13526)
Fix: correct multi-search non-adjacent queries @shamoon (#13504)
Fix: Content-Disposition filename normalization @shamoon (#13514)
Fix: prevent duplicated text query with multiple date queries @shamoon (#13522)
Fix: crash filtering document link custom fields with an unset or unrelated field present @ggouzi (#13518)
Fix: parse unpadded yyyy-mm-dd date input regardless of locale @Se1foo (#13501)
Chore(deps): Bump the frontend-angular-dependencies group across 1 directory with 18 updates @dependabot[bot] (#13476)
Chore(deps-dev): Bump @playwright/test from 1.61.1 to 1.62.0 in /src-ui @dependabot[bot] (#13480)
Chore(deps-dev): Bump the frontend-eslint-dependencies group across 1 directory with 4 updates @dependabot[bot] (#13477)
Chore(deps-dev): Bump @types/node from 26.1.0 to 26.1.1 in /src-ui @dependabot[bot] (#13479)

Paperless-ngx v3.0.5

2026-08-01T21:59:11Z

paperless-ngx 3.0.5

Bug Fixes

Fix: accept Whoosh-era abbreviated relative-date units (yrs, mos, wks, etc) in search queries @stumpylog (#13486)
Fix: fix edit dialog error change detection @shamoon (#13483)
Fix: key the AI suggestion cache by model and endpoint @lunetics (#13449)
Fix: validate custom field values in bulk operations @shamoon (#13457)
Fixhancement: better handle empty fields from AI suggestions @shamoon (#13454)
Fix: normalize monetary decimal symbol by locale @shamoon (#13427)
Fix: fold overflowing path text in sanity checker @stumpylog (#13426)
Fix: correct delayed add field button for custom fields @shamoon (#13424)
Fix: hide attributes collapse / show button without UI settings @shamoon (#13425)
Fix: consolidate born-digital PDF detection between archive decision and OCR @stumpylog (#13409)
Fix: prevent scale vs page loop in pngx PDF viewer @shamoon (#13406)
Fix: handle hidden line breaks in email subjects when sending email @shamoon (#13402)
Fix: avoid NotSupportedError from document_importer on MariaDB @stumpylog (#13400)
Fix: exclude next-period start from relative date-range filters @stumpylog (#13381)
Fix: close non-atomic db connections in before_task_publish @shamoon (#13366)
Chore/fix: refactor frontend task service @shamoon (#13365)
Fix: fix Enter selection in search autocomplete @shamoon (#13361)

Documentation

Documentation: PAPERLESS_CONSUMER_IGNORE_PATTERNS clarifications @shamoon (#13489)
Documentation: Add Password Removal workflow action documentation @stumpylog (#13377)

Dependencies

Chore(deps): Bump pymdown-extensions from 10.21.3 to 11.0 in the uv group across 1 directory @dependabot[bot] (#13378)

All App Changes

21 changes

Fix: accept Whoosh-era abbreviated relative-date units (yrs, mos, wks, etc) in search queries @stumpylog (#13486)
Fix: fix edit dialog error change detection @shamoon (#13483)
Performance: sqlite-vec point-delete for document chunks @stumpylog (#13438)
Fix: key the AI suggestion cache by model and endpoint @lunetics (#13449)
Fix: validate custom field values in bulk operations @shamoon (#13457)
Fixhancement: better handle empty fields from AI suggestions @shamoon (#13454)
Performance: Use server side iterators during LLM index updating @stumpylog (#13430)
Fix: normalize monetary decimal symbol by locale @shamoon (#13427)
Fix: fold overflowing path text in sanity checker @stumpylog (#13426)
Fix: correct delayed add field button for custom fields @shamoon (#13424)
Fix: hide attributes collapse / show button without UI settings @shamoon (#13425)
Fix: consolidate born-digital PDF detection between archive decision and OCR @stumpylog (#13409)
Fix: prevent scale vs page loop in pngx PDF viewer @shamoon (#13406)
Fix: handle hidden line breaks in email subjects when sending email @shamoon (#13402)
Fix: avoid NotSupportedError from document_importer on MariaDB @stumpylog (#13400)
Tweak: adjust doc details button toolbar flow @shamoon (#13382)
Fix: exclude next-period start from relative date-range filters @stumpylog (#13381)
Chore(deps): Bump pymdown-extensions from 10.21.3 to 11.0 in the uv group across 1 directory @dependabot[bot] (#13378)
Fix: close non-atomic db connections in before_task_publish @shamoon (#13366)
Chore/fix: refactor frontend task service @shamoon (#13365)
Fix: fix Enter selection in search autocomplete @shamoon (#13361)

Paperless-ngx v3.0.4

2026-07-28T04:15:01Z

paperless-ngx 3.0.4

Bug Fixes

Fix: prevent pdfjs highlight scrolling from affecting the entire page @shamoon (#13355)
Fix: don't skip OCR/archive for tagged PDFs with no actual text @stumpylog (#13351)
Performance: more efficient diacritic normalization in dropdown filtering @shamoon (#13347)
Fix: dedupe permission-visible documents when combined with multi-tag filters @stumpylog (#13345)
Fixhancement: pass LLM output language to chat if specified @shamoon (#13340)
Fix: ensure preview reload on live changes @shamoon (#13321)
Fix: clamp all out out-of-range possible fields @stumpylog (#13316)
Fix: add docstring to DocumentClassifierSchema for cleaner LLM tool description @stumpylog (#13315)
Fix: guard build_document_node against stale FK on deleted correspondent/doc type @stumpylog (#13318)
Fix: prevent search filter loss when closing document with Escape key @shamoon (#13317)
Fix: fix frontend permissions display for stats/system perms @shamoon (#13305)

Documentation

Documentation: fix PAPERLESS_AI_LLM_OUTPUT_LANGUAGE heading level @SuperSandro2000 (#13341)

Dependencies

Chore: resolve npm provenance issues with chokidar and semver @shamoon (#13323)

All App Changes

14 changes

Fix: prevent pdfjs highlight scrolling from affecting the entire page @shamoon (#13355)
Fix: don't skip OCR/archive for tagged PDFs with no actual text @stumpylog (#13351)
Performance: more efficient diacritic normalization in dropdown filtering @shamoon (#13347)
Performance: prefetch notes and custom fields for LLM index text building @stumpylog (#13350)
Fix: dedupe permission-visible documents when combined with multi-tag filters @stumpylog (#13345)
Performance: Scope llm index updates to actually modified documents @stumpylog (#13322)
Fixhancement: pass LLM output language to chat if specified @shamoon (#13340)
Chore: resolve npm provenance issues with chokidar and semver @shamoon (#13323)
Fix: ensure preview reload on live changes @shamoon (#13321)
Fix: clamp all out out-of-range possible fields @stumpylog (#13316)
Fix: add docstring to DocumentClassifierSchema for cleaner LLM tool description @stumpylog (#13315)
Fix: guard build_document_node against stale FK on deleted correspondent/doc type @stumpylog (#13318)
Fix: prevent search filter loss when closing document with Escape key @shamoon (#13317)
Fix: fix frontend permissions display for stats/system perms @shamoon (#13305)

Paperless-ngx v3.0.3

2026-07-26T00:47:33Z

paperless-ngx 3.0.3

Bug Fixes

Fixhancement: PAPERLESS_ALLAUTH_TRUSTED_PROXY_COUNT @shamoon (#13281)
Fix: preserve document fields during Gotenberg conversion to PDF @stumpylog (#13271)
Fix: Makes the email date aware as soon as possible during parsing @stumpylog (#13266)
Fix: Handle a plain string as Celery sometimes provides for the traceback @stumpylog (#13267)
Fix: Emit the torch index into the requirements.txt for people still using it @stumpylog (#13265)
Fix: handle notes without a user when building the search index @matthiasmast (#13260)

Documentation

Docs: warn bare-metal users about stale files when upgrading @stumpylog (#13296)
Documentation: Add the NumPy CPU baseline increase to the migration guide @stumpylog (#13269)

Maintenance

Fix: Emit the torch index into the requirements.txt for people still using it @stumpylog (#13265)

All App Changes

6 changes

Fixhancement: PAPERLESS_ALLAUTH_TRUSTED_PROXY_COUNT @shamoon (#13281)
Tweak: adjust top navbar wrapping when AI chat button visible @shamoon (#13280)
Fix: preserve document fields during Gotenberg conversion to PDF @stumpylog (#13271)
Fix: Makes the email date aware as soon as possible during parsing @stumpylog (#13266)
Fix: Handle a plain string as Celery sometimes provides for the traceback @stumpylog (#13267)
Fix: handle notes without a user when building the search index @matthiasmast (#13260)

Paperless-ngx v3.0.2

2026-07-24T01:32:46Z

paperless-ngx 3.0.2

Bug Fixes

Fix: fix broken migration in 3.0.1 @shamoon (#13242)

All App Changes

Fix: fix broken migration in 3.0.1 @shamoon (#13242)