Bump version to 3.3.0

Merge branch 'dev'
New Crowdin translations by GitHub Action (#14361 )
2026-10-07 16:47:13 +00:00 · 2026-10-05 20:34:24 -07:00 · 2026-10-05 20:33:36 -07:00 · 2026-10-06 03:29:47 +00:00 · 2026-10-06 03:19:38 +00:00 · 2026-10-05 20:18:09 -07:00
184 changed files with 43038 additions and 34363 deletions
@@ -1010,6 +1010,19 @@ documents to both separate and categorize them in a single operation.
 **Example:** A 6-page scan with TAG:invoice on page 3 and TAG:receipt on page 5 will create
 three documents: pages 1-2 (no tags), pages 3-4 (tagged "invoice"), and pages 5-6 (tagged "receipt").
 ### Barcode Contents {#barcode-contents}
 By default, Paperless only uses barcodes for splitting, ASNs and tags. With
 [`PAPERLESS_CONSUMER_STORE_BARCODE_VALUES`](configuration.md#PAPERLESS_CONSUMER_STORE_BARCODE_VALUES)
 enabled, it stores the content of every barcode with the document, e.g. payment codes or QR codes.
 - Barcodes are listed on the **Metadata** tab with page, type and content, and can be copied.
 - The API returns them in the `barcodes` field of `/api/documents/{id}/metadata/`.
 - They can be [searched](usage.md#searching-barcodes), e.g. `barcodes:DE89370400440532013000`.
 - Only the first [`PAPERLESS_CONSUMER_BARCODE_MAX_PAGES`](configuration.md#PAPERLESS_CONSUMER_BARCODE_MAX_PAGES)
  pages are scanned. Reprocessing reads the barcodes of existing documents.
 - Each version keeps its own barcodes, and the newest version's are shown and searched.
 ## Automatic collation of double-sided documents {#collate}
 !!! note
@@ -1796,6 +1796,13 @@ assigns or creates tags if a properly formatted barcode is detected.
    Defaults to false.
 #### [`PAPERLESS_CONSUMER_STORE_BARCODE_VALUES=<bool>`](#PAPERLESS_CONSUMER_STORE_BARCODE_VALUES) {#PAPERLESS_CONSUMER_STORE_BARCODE_VALUES}
 : Stores the content of every barcode found during consumption, see
 [Barcode Contents](advanced_usage.md#barcode-contents).
    Defaults to false.
 ## Audit Trail
 #### [`PAPERLESS_AUDIT_LOG_ENABLED=<bool>`](#PAPERLESS_AUDIT_LOG_ENABLED) {#PAPERLESS_AUDIT_LOG_ENABLED}
@@ -76,7 +76,9 @@ is not supported by any of the available parsers.
 **A:** Not by default. As of v3, a file whose contents match an existing document is still
 consumed, and the duplicate is flagged in the UI — open the document and check the
-**Duplicates** tab to review documents that share the same content. If you prefer the old
+**Duplicates** tab to review documents that share the same content, or filter the document
 list by **Duplicates** to find all of them (see
 [Duplicate documents](usage.md#duplicate-documents)). If you prefer the old
 behavior of rejecting duplicates during consumption, set
 [`PAPERLESS_CONSUMER_DELETE_DUPLICATES`](configuration.md#PAPERLESS_CONSUMER_DELETE_DUPLICATES)
 to `true`.
@@ -299,19 +299,18 @@ for details.
 ### Duplicate documents
 By default, Paperless-ngx **does not reject duplicates**. If you consume a file whose
-contents exactly match an existing document (same checksum), the new copy is still
+contents match an existing document (same original or archive checksum), the new copy is
-consumed and a warning is logged. The task entry for the upload also flags that a
+still consumed and a warning is logged.
 duplicate was detected and links to the existing document(s).
-To review duplicates, open a document and switch to the **Duplicates** tab on the
+When a document has duplicates, a **Duplicates** tab appears on its detail page, listing
-document detail page. It lists other documents that share the same content, including any
+the other documents you can view that share the same content (including any in the trash).
-that are in the trash (shown with a badge), and links to each so you can decide which to
+To find all documents with duplicates, choose **Duplicates** in the document list's text
-keep.
+filter dropdown, or use `has_duplicates=true` in the REST API.
 If you would rather reject duplicates at consumption time (the pre-v3 behavior), set
 [`PAPERLESS_CONSUMER_DELETE_DUPLICATES`](configuration.md#PAPERLESS_CONSUMER_DELETE_DUPLICATES)
 to `true`. The duplicate file is then deleted instead of consumed, and the task fails with
-a "document already exists" message.
+a "Document already exists" message linking to the existing document.
 ## Document Suggestions
@@ -1061,6 +1060,20 @@ notes.user:alice notes.note:insurance
 The bare `notes:` prefix is shorthand for `notes.note:`.
 #### Searching barcodes
 If [barcode contents are stored](advanced_usage.md#barcode-contents), they can be searched by
 content or type, but only with a field name:
 ```
 barcodes.value:DE89370400440532013000
 barcodes.format:qrcode
 barcodes:wifi barcodes:guest
 ```
 `barcodes:` is shorthand for `barcodes.value:`. Separators are stripped, so each part of e.g.
 `WIFI:S:Guest;P:secret;;` can be searched on its own.
 All of these can be combined. Syntax not described here may not work as expected, and an unknown field name is searched as ordinary text.
 !!! note
@@ -1,6 +1,6 @@
 [project]
 name = "paperless-ngx"
-version = "3.2.1"
+version = "3.3.0"
 description = """\
  A community-supported supercharged document management system: scan, index and archive all your physical documents\
  """
@@ -33,7 +33,7 @@ dependencies = [
  "django-compression-middleware~=0.5.0",
  "django-cors-headers~=4.9.0",
  "django-extensions~=4.1",
-  "django-filter~=25.1",
+  "django-filter>=25.1,<27",
  "django-guardian>=3.3.3,<3.6",
  "django-multiselectfield~=1.0.1",
  "django-rich~=2.2.0",
@@ -90,7 +90,7 @@ postgres = [
  "psycopg[c,pool]==3.3.4",
  # Direct dependency for proper resolution of the pre-built wheels
  "psycopg-c==3.3.4",
-  "psycopg-pool==3.3.2",
+  "psycopg-pool==3.3.3",
 ]
 webserver = [
  "granian[uvloop]>=2.7,<2.9",
@@ -256,8 +256,8 @@ isort.force-single-line = true
 [tool.codespell]
 ignore-words-list = "criterias,afterall,valeu,ureue,equest,ure,assertIn,Oktober,commitish,NIN,nin,reprot"
 skip = """\
-  src-ui/src/locale/*,src-ui/pnpm-lock.yaml,src-ui/e2e/*,src/paperless/tests/samples/mail/*,src/documents/tests/samples\
+  src-ui/src/locale/*,src-ui/pnpm-lock.yaml,src-ui/e2e/*,src/paperless_mail/tests/samples/*,src/paperless/tests/samples\
-  /*,src/paperless_testing/sample_files/*,*.po,*.json\
+  /mail/*,src/documents/tests/samples/*,*.po,*.json\
  """
 write-changes = true
@@ -698,7 +698,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">457,458</context>
+          <context context-type="linenumber">463,464</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/custom-fields-bulk-edit-dialog/custom-fields-bulk-edit-dialog.component.html</context>
@@ -870,7 +870,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">476</context>
+          <context context-type="linenumber">482</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/document-list.component.html</context>
@@ -1373,7 +1373,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1901</context>
+          <context context-type="linenumber">1907</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1577733187050997705" datatype="html">
@@ -1451,7 +1451,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">402,403</context>
+          <context context-type="linenumber">408,409</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.html</context>
@@ -1700,7 +1700,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">177</context>
+          <context context-type="linenumber">179</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2691296884221415710" datatype="html">
@@ -1715,7 +1715,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">182</context>
+          <context context-type="linenumber">184</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.html</context>
@@ -1750,7 +1750,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">186</context>
+          <context context-type="linenumber">188</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.html</context>
@@ -1785,7 +1785,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">190</context>
+          <context context-type="linenumber">192</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.html</context>
@@ -2478,7 +2478,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">711</context>
+          <context context-type="linenumber">713</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-version-dropdown/document-version-dropdown.component.html</context>
@@ -3392,11 +3392,11 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1515</context>
+          <context context-type="linenumber">1521</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1902</context>
+          <context context-type="linenumber">1908</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -4012,7 +4012,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1468</context>
+          <context context-type="linenumber">1474</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -4156,7 +4156,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1955</context>
+          <context context-type="linenumber">1961</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6661109599266152398" datatype="html">
@@ -4167,7 +4167,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1956</context>
+          <context context-type="linenumber">1962</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5162686434580248853" datatype="html">
@@ -4178,7 +4178,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1957</context>
+          <context context-type="linenumber">1963</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6665634854532231106" datatype="html">
@@ -5430,7 +5430,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">368,369</context>
+          <context context-type="linenumber">374,375</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8057014866157903311" datatype="html">
@@ -6311,7 +6311,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1472</context>
+          <context context-type="linenumber">1478</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -6344,7 +6344,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">175</context>
+          <context context-type="linenumber">177</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/document-list.component.html</context>
@@ -7176,6 +7176,10 @@
          <context context-type="sourcefile">src/app/components/common/system-status-dialog/system-status-dialog.component.html</context>
          <context context-type="linenumber">56,57</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-barcodes/document-barcodes.component.html</context>
          <context context-type="linenumber">5,6</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1230154438678955604" datatype="html">
        <source>Change</source>
@@ -7748,8 +7752,8 @@
          <context context-type="linenumber">120</context>
        </context-group>
      </trans-unit>
-      <trans-unit id="5700628356844396417" datatype="html">
+      <trans-unit id="5377184518735933155" datatype="html">
-        <source>{VAR_PLURAL, plural, =1 {1 existing value suggested below} other {<x id="INTERPOLATION"/> existing values suggested below}}</source>
+        <source>{VAR_PLURAL, plural, =1 {1 suggestion available below} other {<x id="INTERPOLATION"/> suggestions available below}}</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/suggestions-dropdown/suggestions-dropdown.component.html</context>
          <context context-type="linenumber">54</context>
@@ -8333,6 +8337,10 @@
      </trans-unit>
      <trans-unit id="1407560924967345762" datatype="html">
        <source>Page</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-barcodes/document-barcodes.component.html</context>
          <context context-type="linenumber">4,5</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
          <context context-type="linenumber">5,6</context>
@@ -8346,6 +8354,28 @@
          <context context-type="linenumber">34</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6205355627445317276" datatype="html">
        <source>Content</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-barcodes/document-barcodes.component.html</context>
          <context context-type="linenumber">6,7</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
          <context context-type="linenumber">300,301</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3846359579066496296" datatype="html">
        <source>Copy content</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-barcodes/document-barcodes.component.html</context>
          <context context-type="linenumber">32,33</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-barcodes/document-barcodes.component.html</context>
          <context context-type="linenumber">40,41</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2266163016683537825" datatype="html">
        <source>of <x id="INTERPOLATION" equiv-text="{{previewNumPages()}}"/></source>
        <context-group purpose="location">
@@ -8477,39 +8507,32 @@
        <source>Details</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">172,173</context>
+          <context context-type="linenumber">174,175</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5114742157723900905" datatype="html">
        <source>Date created</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">179</context>
+          <context context-type="linenumber">181</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5607669932062416162" datatype="html">
        <source>Default</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">191</context>
+          <context context-type="linenumber">193</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/manage/saved-views/saved-views.component.html</context>
          <context context-type="linenumber">71</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6205355627445317276" datatype="html">
        <source>Content</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
          <context context-type="linenumber">298,299</context>
        </context-group>
      </trans-unit>
      <trans-unit id="218403386307979629" datatype="html">
        <source>Metadata</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">307,308</context>
+          <context context-type="linenumber">309,310</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/metadata-collapse/metadata-collapse.component.ts</context>
@@ -8520,228 +8543,235 @@
        <source>Date modified</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">314,315</context>
+          <context context-type="linenumber">316,317</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6392918669949841614" datatype="html">
        <source>Date added</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">318,319</context>
+          <context context-type="linenumber">320,321</context>
        </context-group>
      </trans-unit>
      <trans-unit id="146828917013192897" datatype="html">
        <source>Media filename</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">322,323</context>
+          <context context-type="linenumber">324,325</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4500855521601039868" datatype="html">
        <source>Original filename</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">326,327</context>
+          <context context-type="linenumber">328,329</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2659735245739197634" datatype="html">
        <source>Original SHA256 checksum</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">330,331</context>
+          <context context-type="linenumber">332,333</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5888243105821763422" datatype="html">
        <source>Original file size</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">334,335</context>
+          <context context-type="linenumber">336,337</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2696647325713149563" datatype="html">
        <source>Original mime type</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">338,339</context>
+          <context context-type="linenumber">340,341</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6714358112223607756" datatype="html">
        <source>Archive SHA256 checksum</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">343,344</context>
+          <context context-type="linenumber">345,346</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6033581412811562084" datatype="html">
        <source>Archive file size</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">349,350</context>
+          <context context-type="linenumber">351,352</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8459338343197260257" datatype="html">
        <source>Barcodes</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
          <context context-type="linenumber">360,361</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6992781481378431874" datatype="html">
        <source>Original document metadata</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">358</context>
+          <context context-type="linenumber">364</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2846565152091361585" datatype="html">
        <source>Archived document metadata</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">361</context>
+          <context context-type="linenumber">367</context>
        </context-group>
      </trans-unit>
      <trans-unit id="7206723502037428235" datatype="html">
        <source>Notes <x id="START_BLOCK_IF" equiv-text="@if (document()?.notes.length) {"/><x id="START_TAG_SPAN" ctype="x-span" equiv-text="&lt;span class=&quot;badge text-bg-secondary ms-1&quot;&gt;"/><x id="INTERPOLATION" equiv-text="{{document().notes.length}}"/><x id="CLOSE_TAG_SPAN" ctype="x-span" equiv-text="&lt;/span&gt;"/><x id="CLOSE_BLOCK_IF" equiv-text="}"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">380,383</context>
+          <context context-type="linenumber">386,389</context>
        </context-group>
      </trans-unit>
      <trans-unit id="186236568870281953" datatype="html">
        <source>History</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">391,392</context>
+          <context context-type="linenumber">397,398</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8236092845697214347" datatype="html">
        <source> Duplicates <x id="START_TAG_SPAN" ctype="x-span" equiv-text="&lt;span class=&quot;badge text-bg-secondary ms-1&quot;&gt;"/><x id="INTERPOLATION" equiv-text="{{ document().duplicate_documents.length }}"/><x id="CLOSE_TAG_SPAN" ctype="x-span" equiv-text="&lt;/span&gt;"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">414,417</context>
+          <context context-type="linenumber">420,423</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6449374629822973702" datatype="html">
        <source>Duplicate documents detected:</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">419,420</context>
+          <context context-type="linenumber">425,426</context>
        </context-group>
      </trans-unit>
      <trans-unit id="14058600336670816" datatype="html">
        <source>In trash</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">430,431</context>
+          <context context-type="linenumber">436,437</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5129524307369213584" datatype="html">
        <source>Save &amp; next</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">459</context>
+          <context context-type="linenumber">465</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4910102545766233758" datatype="html">
        <source>Save &amp; close</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">461</context>
+          <context context-type="linenumber">467</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3823219296477075982" datatype="html">
        <source>Discard</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">463,464</context>
+          <context context-type="linenumber">469,470</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1309556917227148591" datatype="html">
        <source>Document loading...</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">471</context>
+          <context context-type="linenumber">477</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8191371354890763172" datatype="html">
        <source>Enter Password</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">525</context>
+          <context context-type="linenumber">531</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5758784066858623886" datatype="html">
        <source>Error retrieving metadata</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">461</context>
+          <context context-type="linenumber">463</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2218903673684131427" datatype="html">
        <source>An error occurred loading content: <x id="PH" equiv-text="err.message ?? err.toString()"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">564,566</context>
+          <context context-type="linenumber">566,568</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1045,1047</context>
+          <context context-type="linenumber">1047,1049</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6357361810318120957" datatype="html">
        <source>Document was updated</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">706</context>
+          <context context-type="linenumber">708</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5154064822428631306" datatype="html">
        <source>Document was updated at <x id="PH" equiv-text="formattedModified"/>.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">707</context>
+          <context context-type="linenumber">709</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8462497568316256794" datatype="html">
        <source>Reload to discard your local unsaved edits and load the latest remote version.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">708</context>
+          <context context-type="linenumber">710</context>
        </context-group>
      </trans-unit>
      <trans-unit id="7967484035994732534" datatype="html">
        <source>Reload</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">710</context>
+          <context context-type="linenumber">712</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2907037627372942104" datatype="html">
        <source>Document reloaded with latest changes.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">766</context>
+          <context context-type="linenumber">768</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6435639868943916539" datatype="html">
        <source>Document reloaded.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">777</context>
+          <context context-type="linenumber">779</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6142395741265832184" datatype="html">
        <source>Next document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">879</context>
+          <context context-type="linenumber">881</context>
        </context-group>
      </trans-unit>
      <trans-unit id="651985345816518480" datatype="html">
        <source>Previous document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">889</context>
+          <context context-type="linenumber">891</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2885986061416655600" datatype="html">
        <source>Close document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">897</context>
+          <context context-type="linenumber">899</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/services/open-documents.service.ts</context>
@@ -8752,28 +8782,28 @@
        <source>Save document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">904</context>
+          <context context-type="linenumber">906</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1784543155727940353" datatype="html">
        <source>Save and close / next</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">913</context>
+          <context context-type="linenumber">915</context>
        </context-group>
      </trans-unit>
      <trans-unit id="7427704425579737895" datatype="html">
        <source>Error retrieving version content</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1027</context>
+          <context context-type="linenumber">1029</context>
        </context-group>
      </trans-unit>
      <trans-unit id="159901853873315050" datatype="html">
        <source>Unsaved Changes</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1071</context>
+          <context context-type="linenumber">1073</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/guards/dirty-form.guard.ts</context>
@@ -8796,74 +8826,74 @@
        <source>You have unsaved changes to the content of this version.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1072</context>
+          <context context-type="linenumber">1074</context>
        </context-group>
      </trans-unit>
      <trans-unit id="85184271222513014" datatype="html">
        <source>Switching versions will discard them.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1073</context>
+          <context context-type="linenumber">1075</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2565707334844767610" datatype="html">
        <source>Discard and switch</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1075</context>
+          <context context-type="linenumber">1077</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2109314380040637387" datatype="html">
        <source>Save and switch</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1077</context>
+          <context context-type="linenumber">1079</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3456881259945295697" datatype="html">
        <source>Error retrieving suggestions.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1120</context>
+          <context context-type="linenumber">1122</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2194092841814123758" datatype="html">
        <source>Document &quot;<x id="PH" equiv-text="newValues.title"/>&quot; saved successfully.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1347</context>
+          <context context-type="linenumber">1353</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1375</context>
+          <context context-type="linenumber">1381</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6626387786259219838" datatype="html">
        <source>Error saving document &quot;<x id="PH" equiv-text="this.document().title"/>&quot;</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1381</context>
+          <context context-type="linenumber">1387</context>
        </context-group>
      </trans-unit>
      <trans-unit id="448882439049417053" datatype="html">
        <source>Error saving document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1436</context>
+          <context context-type="linenumber">1442</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8410796510716511826" datatype="html">
        <source>Do you really want to move the document &quot;<x id="PH" equiv-text="this.document().title"/>&quot; to the trash?</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1469</context>
+          <context context-type="linenumber">1475</context>
        </context-group>
      </trans-unit>
      <trans-unit id="282586936710748252" datatype="html">
        <source>Documents can be restored prior to permanent deletion.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1470</context>
+          <context context-type="linenumber">1476</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -8874,14 +8904,14 @@
        <source>Error deleting document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1491</context>
+          <context context-type="linenumber">1497</context>
        </context-group>
      </trans-unit>
      <trans-unit id="619486176823357521" datatype="html">
        <source>Reprocess confirm</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1511</context>
+          <context context-type="linenumber">1517</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -8892,102 +8922,102 @@
        <source>This operation will permanently recreate the archive file for this document.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1512</context>
+          <context context-type="linenumber">1518</context>
        </context-group>
      </trans-unit>
      <trans-unit id="302054111564709516" datatype="html">
        <source>The archive file will be re-generated with the current settings.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1513</context>
+          <context context-type="linenumber">1519</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4700389117298802932" datatype="html">
        <source>Reprocess operation for &quot;<x id="PH" equiv-text="this.document().title"/>&quot; will begin in the background.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1526</context>
+          <context context-type="linenumber">1532</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4409560272830824468" datatype="html">
        <source>Error executing operation</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1537</context>
+          <context context-type="linenumber">1543</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6030453331794586802" datatype="html">
        <source>Error downloading document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1601</context>
+          <context context-type="linenumber">1607</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4458954481601077369" datatype="html">
        <source>Page Fit</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1679</context>
+          <context context-type="linenumber">1685</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4663705961777238777" datatype="html">
        <source>PDF edit operation for &quot;<x id="PH" equiv-text="this.document().title"/>&quot; will begin in the background.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1922</context>
+          <context context-type="linenumber">1928</context>
        </context-group>
      </trans-unit>
      <trans-unit id="9043972994040261999" datatype="html">
        <source>Error executing PDF edit operation</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1934</context>
+          <context context-type="linenumber">1940</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6172690334763056188" datatype="html">
        <source>Please enter the current password before attempting to remove it.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1945</context>
+          <context context-type="linenumber">1951</context>
        </context-group>
      </trans-unit>
      <trans-unit id="968660764814228922" datatype="html">
        <source>Password removal operation for &quot;<x id="PH" equiv-text="this.document().title"/>&quot; will begin in the background.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1979</context>
+          <context context-type="linenumber">1985</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2282118435712883014" datatype="html">
        <source>Error executing password removal operation</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1993</context>
+          <context context-type="linenumber">1999</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3740891324955700797" datatype="html">
        <source>Print failed.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">2043</context>
+          <context context-type="linenumber">2049</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6457245677384603573" datatype="html">
        <source>Error loading document for printing.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">2052</context>
+          <context context-type="linenumber">2058</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6085793215710522488" datatype="html">
        <source>An error occurred loading tiff: <x id="PH" equiv-text="err.toString()"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">2135</context>
+          <context context-type="linenumber">2141</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">2141</context>
+          <context context-type="linenumber">2147</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4958946940233632319" datatype="html">
@@ -12053,123 +12083,130 @@
          <context context-type="linenumber">328</context>
        </context-group>
      </trans-unit>
      <trans-unit id="906679600349814230" datatype="html">
        <source>Store Barcode Contents</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
          <context context-type="linenumber">335</context>
        </context-group>
      </trans-unit>
      <trans-unit id="7011909364081812031" datatype="html">
        <source>AI Enabled</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">335</context>
+          <context context-type="linenumber">342</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8028880048909383956" datatype="html">
        <source>Consider privacy implications when enabling AI features, especially if using a remote model.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">339</context>
+          <context context-type="linenumber">346</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8131374115579345652" datatype="html">
        <source>LLM Embedding Backend</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">343</context>
+          <context context-type="linenumber">350</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6647708571891295756" datatype="html">
        <source>LLM Embedding Model</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">351</context>
+          <context context-type="linenumber">358</context>
        </context-group>
      </trans-unit>
      <trans-unit id="861068592166833023" datatype="html">
        <source>LLM Embedding API Key</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">358</context>
+          <context context-type="linenumber">365</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2929108042259892948" datatype="html">
        <source>Used for embeddings when set, otherwise LLM API key is used.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">360</context>
+          <context context-type="linenumber">367</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3554114880473286122" datatype="html">
        <source>LLM Embedding Endpoint</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">366</context>
+          <context context-type="linenumber">373</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1044242175651289991" datatype="html">
        <source>LLM Embedding Chunk Size</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">373</context>
+          <context context-type="linenumber">380</context>
        </context-group>
      </trans-unit>
      <trans-unit id="7218245223139363113" datatype="html">
        <source>LLM Context Size</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">380</context>
+          <context context-type="linenumber">387</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4234495692726214397" datatype="html">
        <source>LLM Backend</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">387</context>
+          <context context-type="linenumber">394</context>
        </context-group>
      </trans-unit>
      <trans-unit id="7935234833834000002" datatype="html">
        <source>LLM Model</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">395</context>
+          <context context-type="linenumber">402</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1980550530387803165" datatype="html">
        <source>LLM API Key</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">402</context>
+          <context context-type="linenumber">409</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6126617860376156501" datatype="html">
        <source>LLM Endpoint</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">409</context>
+          <context context-type="linenumber">416</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6572826277249350975" datatype="html">
        <source>LLM Output Language</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">416</context>
+          <context context-type="linenumber">423</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3284403507172415792" datatype="html">
        <source>Language to use for generated AI suggestions. When unset, AI suggestions use the user&apos;s display language if explicitly set.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">420</context>
+          <context context-type="linenumber">427</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4493921125434706859" datatype="html">
        <source>LLM Request Timeout</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">424</context>
+          <context context-type="linenumber">431</context>
        </context-group>
      </trans-unit>
      <trans-unit id="483994032066441287" datatype="html">
        <source>Timeout in seconds for LLM requests.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/data/paperless-config.ts</context>
-          <context context-type="linenumber">428</context>
+          <context context-type="linenumber">435</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1055686627716339120" datatype="html">
@@ -1,6 +1,6 @@
 {
  "name": "paperless-ngx-ui",
-  "version": "3.2.1",
+  "version": "3.3.0",
  "scripts": {
    "preinstall": "npx only-allow pnpm",
    "ng": "ng",
@@ -26,7 +26,7 @@
        <div ngbDropdownMenu aria-labelledby="suggestionsDropdown" class="shadow suggestions-dropdown">
          <div class="list-group list-group-flush small pb-0">
-            @if (novelSuggestions === 0 && reusableSuggestions === 0) {
+            @if (novelSuggestions === 0 && fieldSuggestions === 0) {
              <div class="list-group-item text-muted fst-italic">
                <small class="text-muted small fst-italic" i18n>No novel suggestions</small>
              </div>
@@ -49,9 +49,9 @@
                <button type="button" class="list-group-item list-group-item-action bg-light" (click)="addCorrespondent.emit(correspondent)">{{ correspondent }}</button>
              }
            }
-            @if (reusableSuggestions > 0) {
+            @if (fieldSuggestions > 0) {
              <div class="list-group-item text-muted fst-italic">
-                <small class="text-muted small fst-italic" i18n>{reusableSuggestions, plural, =1 {1 existing value suggested below} other {{{reusableSuggestions}} existing values suggested below}}</small>
+                <small class="text-muted small fst-italic" i18n>{fieldSuggestions, plural, =1 {1 suggestion available below} other {{{fieldSuggestions}} suggestions available below}}</small>
              </div>
            }
          </div>
@@ -84,7 +84,7 @@ describe('SuggestionsDropdownComponent', () => {
    fixture.detectChanges()
    expect(fixture.nativeElement.textContent).toContain(
-      '2 existing values suggested below'
+      '2 suggestions available below'
    )
    expect(fixture.nativeElement.textContent).not.toContain(
      'No novel suggestions'
@@ -108,7 +108,7 @@ describe('SuggestionsDropdownComponent', () => {
    expect(component.totalSuggestions).toBe(4)
    expect(fixture.nativeElement.textContent).toContain('Arbitration')
    expect(fixture.nativeElement.textContent).toContain(
-      '2 existing values suggested below'
+      '2 suggestions available below'
    )
  })
@@ -125,10 +125,46 @@ describe('SuggestionsDropdownComponent', () => {
    })
    expect(component.novelSuggestions).toBe(0)
-    expect(component.totalSuggestions).toBe(5)
+    expect(component.totalSuggestions).toBe(6)
    fixture.componentRef.setInput('appliedStoragePath', 7)
-    expect(component.totalSuggestions).toBe(4)
+    expect(component.totalSuggestions).toBe(5)
  })
  it('should count title and dates as field suggestions without calling them existing values', () => {
    fixture.componentRef.setInput('aiEnabled', true)
    fixture.componentRef.setInput('fetchedSources', [SuggestionSource.ML])
    fixture.componentRef.setInput('suggestions', {
      title: 'Suggested title',
      dates: ['2026-01-04', '2026-02-01', '2026-03-01'],
      correspondents: [1, 2, 3, 4],
      document_types: [1, 2, 3, 4],
      tags: [1, 2, 3, 4, 5, 6, 7, 8],
    })
    fixture.detectChanges()
    component.clickSuggest()
    fixture.detectChanges()
    expect(component.reusableSuggestions).toBe(16)
    expect(component.fieldSuggestions).toBe(20)
    expect(component.totalSuggestions).toBe(20)
    expect(fixture.nativeElement.textContent).toContain(
      '20 suggestions available below'
    )
    expect(fixture.nativeElement.textContent).not.toContain('existing value')
  })
  it('should not count title or date suggestions matching the current values', () => {
    fixture.componentRef.setInput('suggestions', {
      title: 'Current title',
      dates: ['2026-01-04', '2026-02-01'],
    })
    expect(component.fieldSuggestions).toBe(3)
    fixture.componentRef.setInput('appliedTitle', 'Current title')
    fixture.componentRef.setInput('appliedCreated', '2026-01-04')
    expect(component.fieldSuggestions).toBe(1)
    expect(component.totalSuggestions).toBe(1)
  })
  it('should show when a completed request returned no suggestions', () => {
@@ -145,6 +181,28 @@ describe('SuggestionsDropdownComponent', () => {
    expect(fixture.nativeElement.textContent).toContain('No suggestions')
  })
  it('should wait for all pending responses before showing the empty state', () => {
    fixture.componentRef.setInput('aiEnabled', true)
    fixture.componentRef.setInput('source', SuggestionSource.Both)
    fixture.componentRef.setInput('fetchedSources', [SuggestionSource.ML])
    fixture.componentRef.setInput('suggestions', { tags: [] })
    fixture.componentRef.setInput('loading', true)
    fixture.detectChanges()
    expect(component.noSuggestions).toBeFalsy()
    expect(fixture.nativeElement.textContent).not.toContain('No suggestions')
    expect(
      fixture.nativeElement.querySelector('[role="status"]')
    ).not.toBeNull()
    fixture.componentRef.setInput('loading', false)
    fixture.detectChanges()
    expect(component.noSuggestions).toBeTruthy()
    expect(fixture.nativeElement.textContent).toContain('No suggestions')
    expect(fixture.nativeElement.querySelector('[role="status"]')).toBeNull()
  })
  it('should not show the empty state before a request or with suggestions', () => {
    expect(component.noSuggestions).toBeFalsy()
@@ -34,6 +34,8 @@ export class SuggestionsDropdownComponent {
  readonly appliedCorrespondent = input<number>(null)
  readonly appliedDocumentType = input<number>(null)
  readonly appliedStoragePath = input<number>(null)
  readonly appliedTitle = input<string>(null)
  readonly appliedCreated = input<string>(null)
  @Output()
  getSuggestions: EventEmitter<SuggestionSource> = new EventEmitter()
@@ -128,7 +130,28 @@ export class SuggestionsDropdownComponent {
  }
  get totalSuggestions(): number {
-    return this.novelSuggestions + this.reusableSuggestions
+    return this.novelSuggestions + this.fieldSuggestions
  }
  get fieldSuggestions(): number {
    return (
      this.reusableSuggestions +
      this.unappliedTitleSuggestions +
      this.unappliedDateSuggestions
    )
  }
  // hide a title or date suggestion equal to the current value
  private get unappliedTitleSuggestions(): number {
    const title = this.suggestions()?.title
    return title && title !== this.appliedTitle() ? 1 : 0
  }
  private get unappliedDateSuggestions(): number {
    const created = this.appliedCreated()
    return (this.suggestions()?.dates ?? []).filter(
      (date) => !created || date !== created
    ).length
  }
  private countUnapplied(suggested: number[], applied: number[]): number {
@@ -139,6 +162,7 @@ export class SuggestionsDropdownComponent {
  get noSuggestions(): boolean {
    const suggestions = this.suggestions()
    return (
      !this.loading() &&
      suggestions != null &&
      !suggestions.title &&
      !suggestions.tags?.length &&
@@ -0,0 +1,46 @@
 <table class="table table-borderless align-baseline">
  <thead>
    <tr>
      <th i18n>Page</th>
      <th i18n>Type</th>
      <th i18n>Content</th>
      <th></th>
    </tr>
  </thead>
  <tbody>
    @for (barcode of barcodes(); track $index) {
      <tr>
        <td>{{ barcode.page }}</td>
        <td class="text-nowrap">{{ barcode.format }}</td>
        <td class="text-break">
          @if (isLink(barcode.value)) {
            <a
              [href]="barcode.value"
              target="_blank"
              rel="noopener noreferrer nofollow"
              >{{ barcode.value }}</a
            >
          } @else {
            {{ barcode.value }}
          }
        </td>
        <td class="text-end">
          <button
            type="button"
            class="btn btn-sm btn-outline-primary"
            (click)="copy($index)"
            title="Copy content"
            i18n-title
          >
            @if (copiedIndex() === $index) {
              <i-bs name="clipboard-check"></i-bs>
            } @else {
              <i-bs name="clipboard"></i-bs>
            }
            <span class="visually-hidden" i18n>Copy content</span>
          </button>
        </td>
      </tr>
    }
  </tbody>
 </table>
@@ -0,0 +1,73 @@
 import { Clipboard } from '@angular/cdk/clipboard'
 import { ComponentFixture, TestBed } from '@angular/core/testing'
 import { NgxBootstrapIconsModule, allIcons } from 'ngx-bootstrap-icons'
 import { DocumentBarcodesComponent } from './document-barcodes.component'
 const barcodes = [
  { page: 1, value: 'ASN00123', format: 'Code128' },
  { page: 2, value: 'https://example.com/invoice/4711', format: 'QRCode' },
  { page: 2, value: 'javascript:alert(1)', format: 'QRCode' },
 ]
 describe('DocumentBarcodesComponent', () => {
  let component: DocumentBarcodesComponent
  let fixture: ComponentFixture<DocumentBarcodesComponent>
  let clipboard: Clipboard
  beforeEach(async () => {
    TestBed.configureTestingModule({
      imports: [
        DocumentBarcodesComponent,
        NgxBootstrapIconsModule.pick(allIcons),
      ],
    }).compileComponents()
    fixture = TestBed.createComponent(DocumentBarcodesComponent)
    component = fixture.componentInstance
    clipboard = TestBed.inject(Clipboard)
    fixture.componentRef.setInput('barcodes', barcodes)
    fixture.detectChanges()
  })
  it('should display all barcodes', () => {
    const rows = fixture.nativeElement.querySelectorAll('tbody tr')
    expect(rows).toHaveLength(3)
    expect(rows[0].textContent).toContain('ASN00123')
    expect(rows[0].textContent).toContain('Code128')
  })
  it('should only link http(s) values', () => {
    const links = fixture.nativeElement.querySelectorAll('tbody a')
    expect(links).toHaveLength(1)
    expect(links[0].getAttribute('href')).toEqual(
      'https://example.com/invoice/4711'
    )
    expect(links[0].getAttribute('target')).toEqual('_blank')
  })
  it('should copy a value and show feedback', () => {
    jest.useFakeTimers()
    const copySpy = jest.spyOn(clipboard, 'copy').mockReturnValue(true)
    const buttons = fixture.nativeElement.querySelectorAll('tbody button')
    buttons[0].click()
    fixture.detectChanges()
    expect(copySpy).toHaveBeenCalledWith('ASN00123')
    expect(component.copiedIndex()).toEqual(0)
    expect(buttons[0].querySelector('i-bs').getAttribute('name')).toEqual(
      'clipboard-check'
    )
    jest.advanceTimersByTime(3000)
    fixture.detectChanges()
    expect(component.copiedIndex()).toBeNull()
    expect(buttons[0].querySelector('i-bs').getAttribute('name')).toEqual(
      'clipboard'
    )
    jest.useRealTimers()
  })
  it('should not show feedback if copying failed', () => {
    jest.spyOn(clipboard, 'copy').mockReturnValue(false)
    component.copy(1)
    expect(component.copiedIndex()).toBeNull()
  })
 })
@@ -0,0 +1,38 @@
 import { Clipboard } from '@angular/cdk/clipboard'
 import { Component, inject, input, OnDestroy, signal } from '@angular/core'
 import { NgxBootstrapIconsModule } from 'ngx-bootstrap-icons'
 import { DocumentBarcode } from 'src/app/data/document-barcode'
@Component({
  selector: 'pngx-document-barcodes',
  templateUrl: './document-barcodes.component.html',
  imports: [NgxBootstrapIconsModule],
 })
 export class DocumentBarcodesComponent implements OnDestroy {
  private readonly clipboard = inject(Clipboard)
  readonly barcodes = input<DocumentBarcode[]>([])
  readonly copiedIndex = signal<number>(null)
  private copyTimeout: ReturnType<typeof setTimeout>
  public isLink(value: string): boolean {
    try {
      const url = new URL(value.trim())
      return ['http:', 'https:'].includes(url.protocol) && !!url.host
    } catch {
      return false
    }
  }
  public copy(index: number) {
    if (!this.clipboard.copy(this.barcodes()[index].value)) return
    this.copiedIndex.set(index)
    clearTimeout(this.copyTimeout)
    this.copyTimeout = setTimeout(() => this.copiedIndex.set(null), 3000)
  }
  ngOnDestroy(): void {
    clearTimeout(this.copyTimeout)
  }
 }
@@ -141,6 +141,8 @@
                [appliedCorrespondent]="documentForm.value.correspondent"
                [appliedDocumentType]="documentForm.value.document_type"
                [appliedStoragePath]="documentForm.value.storage_path"
                [appliedTitle]="documentForm.value.title"
                [appliedCreated]="documentForm.value.created"
                (getSuggestions)="getSuggestions($event)"
                (sourceChange)="suggestionSourceOverride.set($event)"
                (addTag)="createTag($event)"
@@ -354,6 +356,10 @@
              </table>
            }
            @if (metadata()?.barcodes?.length > 0) {
              <h6 i18n>Barcodes</h6>
              <pngx-document-barcodes [barcodes]="metadata().barcodes"></pngx-document-barcodes>
            }
            @if (metadata()?.original_metadata?.length > 0) {
              <pngx-metadata-collapse i18n-title title="Original document metadata" [metadata]="metadata()?.original_metadata"></pngx-metadata-collapse>
            }
@@ -662,6 +662,45 @@ describe('DocumentDetailComponent', () => {
    )
  })
  it.each([
    ['tag', 'createTag', 'tags', 'suggested_tags'],
    [
      'document type',
      'createDocumentType',
      'document_type',
      'suggested_document_types',
    ],
    [
      'correspondent',
      'createCorrespondent',
      'correspondent',
      'suggested_correspondents',
    ],
  ])(
    'should create a %s after ML-only suggestions',
    (_, method, field, suggestedField) => {
      initNormally()
      component.suggestions.set({ tags: [1] })
      let openModal: NgbModalRef
      modalService.activeInstances.subscribe((modal) => (openModal = modal[0]))
      component[method]('New value')
      openModal.componentInstance.succeeded.next({
        id: 12,
        name: 'New value',
        is_inbox_tag: false,
        color: '#ff0000',
        text_color: '#000000',
      })
      if (field === 'tags') {
        expect(component.tagsInput.value).toContain(12)
      } else {
        expect(component.documentForm.get(field).value).toBe(12)
      }
      expect(component.suggestions()[suggestedField]).toEqual([])
    }
  )
  it('should support creating storage path', () => {
    initNormally()
    let openModal: NgbModalRef
@@ -135,6 +135,7 @@ import { ShareLinksDialogComponent } from '../common/share-links-dialog/share-li
 import { SuggestionsDropdownComponent } from '../common/suggestions-dropdown/suggestions-dropdown.component'
 import { DocumentNotesComponent } from '../document-notes/document-notes.component'
 import { ComponentWithPermissions } from '../with-permissions/with-permissions.component'
 import { DocumentBarcodesComponent } from './document-barcodes/document-barcodes.component'
 import { DocumentHistoryComponent } from './document-history/document-history.component'
 import { DocumentVersionDropdownComponent } from './document-version-dropdown/document-version-dropdown.component'
 import { MetadataCollapseComponent } from './metadata-collapse/metadata-collapse.component'
@@ -177,6 +178,7 @@ interface IncomingDocumentUpdate {
    DateComponent,
    DocumentLinkComponent,
    MetadataCollapseComponent,
    DocumentBarcodesComponent,
    PermissionsFormComponent,
    SelectComponent,
    TagsComponent,
@@ -1152,7 +1154,7 @@ export class DocumentDetailComponent
          if (this.suggestions()) {
            this.suggestions.set({
              ...this.suggestions(),
-              suggested_tags: this.suggestions().suggested_tags.filter(
+              suggested_tags: (this.suggestions().suggested_tags ?? []).filter(
                (tag) => tag !== newTag.name
              ),
            })
@@ -1191,10 +1193,12 @@ export class DocumentDetailComponent
        this.documentForm.get('document_type').setValue(newDocumentType.id)
        this.documentForm.get('document_type').markAsDirty()
        if (this.suggestions()) {
-          this.suggestions().suggested_document_types =
+          this.suggestions.set({
-            this.suggestions().suggested_document_types.filter(
+            ...this.suggestions(),
-              (dt) => dt !== newName
+            suggested_document_types: (
-            )
+              this.suggestions().suggested_document_types ?? []
            ).filter((dt) => dt !== newName),
          })
        }
      })
  }
@@ -1221,10 +1225,12 @@ export class DocumentDetailComponent
        this.documentForm.get('correspondent').setValue(newCorrespondent.id)
        this.documentForm.get('correspondent').markAsDirty()
        if (this.suggestions()) {
-          this.suggestions().suggested_correspondents =
+          this.suggestions.set({
-            this.suggestions().suggested_correspondents.filter(
+            ...this.suggestions(),
-              (c) => c !== newName
+            suggested_correspondents: (
-            )
+              this.suggestions().suggested_correspondents ?? []
            ).filter((c) => c !== newName),
          })
        }
      })
  }
@@ -0,0 +1,7 @@
 export interface DocumentBarcode {
  page: number
  value: string
  format: string
 }
@@ -1,3 +1,5 @@
 import { DocumentBarcode } from './document-barcode'
 export interface DocumentMetadata {
  original_checksum?: string
@@ -12,4 +14,6 @@ export interface DocumentMetadata {
  has_archive_version?: boolean
  lang?: string
  barcodes?: DocumentBarcode[]
 }
@@ -330,6 +330,13 @@ export const PaperlessConfigOptions: ConfigOption[] = [
    config_key: 'PAPERLESS_CONSUMER_TAG_BARCODE_SPLIT',
    category: ConfigCategory.Barcode,
  },
  {
    key: 'barcode_store_values',
    title: $localize`Store Barcode Contents`,
    type: ConfigOptionType.Boolean,
    config_key: 'PAPERLESS_CONSUMER_STORE_BARCODE_VALUES',
    category: ConfigCategory.Barcode,
  },
  {
    key: 'ai_enabled',
    title: $localize`AI Enabled`,
@@ -458,6 +465,7 @@ export interface PaperlessConfig extends ObjectWithId {
  barcode_enable_tag: boolean
  barcode_tag_mapping: object
  barcode_tag_split: boolean
  barcode_store_values: boolean
  remote_ocr_engine: string
  remote_ocr_api_key: string
  remote_ocr_endpoint: string
@@ -8,7 +8,7 @@ export const environment = {
  apiVersion: '10', // match src/paperless/settings.py
  appTitle: DEFAULT_APP_TITLE,
  tag: 'prod',
-  version: '3.2.1',
+  version: '3.3.0',
  webSocketHost: window.location.host,
  webSocketProtocol: window.location.protocol == 'https:' ? 'wss:' : 'ws:',
  webSocketBaseUrl: base_url.pathname + 'ws/',
@@ -11,8 +11,6 @@ from typing import TYPE_CHECKING
 import pytest
 from paperless_testing import samples
 if TYPE_CHECKING:
    from collections.abc import Generator
    from pathlib import Path
@@ -151,39 +149,3 @@ def fake_progress_manager(
    monkeypatch.setattr("documents.tasks.ProgressManager", FakeProgressManager)
    return FakeProgressManager
@pytest.fixture(scope="session")
 def shared_samples_dir() -> Path:
    """Directory of sample files used by more than one app's tests."""
    return samples.SHARED_SAMPLES_DIR
@pytest.fixture(scope="session")
 def simple_digital_pdf_file() -> Path:
    """One-page PDF with a text layer."""
    return samples.SIMPLE_DIGITAL_PDF
@pytest.fixture(scope="session")
 def multi_page_digital_pdf_file() -> Path:
    """Three-page PDF with a text layer."""
    return samples.MULTI_PAGE_DIGITAL_PDF
@pytest.fixture(scope="session")
 def with_form_pdf_file() -> Path:
    """PDF containing a fillable form."""
    return samples.WITH_FORM_PDF
@pytest.fixture(scope="session")
 def multi_page_images_pdf_file() -> Path:
    """Multi-page PDF of scanned images, no text layer."""
    return samples.MULTI_PAGE_IMAGES_PDF
@pytest.fixture(scope="session")
 def thumbnail_webp_file() -> Path:
    """Small WebP thumbnail."""
    return samples.THUMBNAIL_WEBP
@@ -18,6 +18,7 @@ from documents.converters import convert_from_tiff_to_pdf
 from documents.data_models import ConsumableDocument
 from documents.data_models import DocumentMetadataOverrides
 from documents.data_models import DocumentSource
 from documents.data_models import StoredBarcode
 from documents.models import Document
 from documents.models import PaperlessTask
 from documents.models import Tag
@@ -47,6 +48,7 @@ class Barcode:
    page: int
    value: str
    settings: BarcodeConfig
    format: str = ""
    @property
    def is_separator(self) -> bool:
@@ -78,6 +80,12 @@ class Barcode:
                return True
        return False
    def stored(self) -> StoredBarcode:
        """
        The barcode as it is stored with a document, page 1-indexed
        """
        return {"page": self.page + 1, "value": self.value, "format": self.format}
 class BarcodePlugin(ConsumeTaskPlugin):
    NAME: str = "BarcodePlugin"
@@ -89,16 +97,12 @@ class BarcodePlugin(ConsumeTaskPlugin):
          - ASN from barcode detection is enabled or
          - Barcode support is enabled and the mime type is supported
        """
        if self.settings.barcode_enable_tiff_support:
            supported_mimes: set[str] = {"application/pdf", "image/tiff"}
        else:
            supported_mimes = {"application/pdf"}
        return (
            self.settings.barcode_enable_asn
            or self.settings.barcodes_enabled
            or self.settings.barcode_enable_tag
-        ) and self.input_doc.mime_type in supported_mimes
+            or self.settings.barcode_store_values
        ) and self.input_doc.mime_type in scannable_mime_types(self.settings)
    def get_settings(self) -> BarcodeConfig:
        """
@@ -244,6 +248,10 @@ class BarcodePlugin(ConsumeTaskPlugin):
        if self.settings.barcode_enable_asn and (located_asn := self.asn) is not None:
            self._apply_detected_asn(located_asn)
        # After splitting too, so each split document keeps its own barcodes
        if self.settings.barcode_store_values:
            self.metadata.barcodes = [x.stored() for x in self.barcodes] or None
    def cleanup(self) -> None:
        self.temp_dir.cleanup()
@@ -262,22 +270,6 @@ class BarcodePlugin(ConsumeTaskPlugin):
        )
        self._tiff_conversion_done = True
    @staticmethod
    def read_barcodes_zxing(image: Image.Image) -> list[str]:
        barcodes = []
        import zxingcpp
        detected_barcodes = zxingcpp.read_barcodes(image)
        for barcode in detected_barcodes:
            if barcode.text:
                barcodes.append(barcode.text)
                logger.debug(
                    f"Barcode of type {barcode.format} found: {barcode.text}",
                )
        return barcodes
    def detect(self) -> None:
        """
        Scan all pages of the PDF as images, updating barcodes and the pages
@@ -291,60 +283,12 @@ class BarcodePlugin(ConsumeTaskPlugin):
        self.convert_from_tiff_to_pdf()
        try:
-            # Read number of pages from pdf
+            self.barcodes = scan_pdf(
-            with Pdf.open(self.pdf_file) as pdf:
+                self.pdf_file,
-                num_of_pages = len(pdf.pages)
+                self.settings,
-            logger.debug(f"PDF has {num_of_pages} pages")
+                Path(self.temp_dir.name),
            # Get limit from configuration
            barcode_max_pages: int = (
                num_of_pages
                if self.settings.barcode_max_pages == 0
                else self.settings.barcode_max_pages
            )
            if barcode_max_pages < num_of_pages:  # pragma: no cover
                logger.debug(
                    f"Barcodes detection will be limited to the first {barcode_max_pages} pages",
                )
            # Loop al page
            for current_page_number in range(min(num_of_pages, barcode_max_pages)):
                logger.debug(f"Processing page {current_page_number}")
                # Convert page to image
                page = convert_from_path(
                    self.pdf_file,
                    dpi=self.settings.barcode_dpi,
                    output_folder=self.temp_dir.name,
                    first_page=current_page_number + 1,
                    last_page=current_page_number + 1,
                )[0]
                # Remember filename, since it is lost by upscaling
                page_filepath = Path(page.filename)
                logger.debug(f"Image is at {page_filepath}")
                # Upscale image if configured
                factor = self.settings.barcode_upscale
                if factor > 1.0:
                    logger.debug(
                        f"Upscaling image by {factor} for better barcode detection",
                    )
                    x, y = page.size
                    page = page.resize(
                        (round(x * factor), (round(y * factor))),
                    )
                # Detect barcodes
                for barcode_value in self.read_barcodes_zxing(page):
                    self.barcodes.append(
                        Barcode(current_page_number, barcode_value, self.settings),
                    )
                # Delete temporary image file
                page_filepath.unlink()
        # Password protected files can't be checked
        # This is the exception raised for those
        except PasswordError as e:
@@ -534,3 +478,111 @@ class BarcodePlugin(ConsumeTaskPlugin):
                document_paths.append(savepath)
            return document_paths
 def scannable_mime_types(settings: BarcodeConfig) -> set[str]:
    """
    The file types the barcode scan supports with the current settings
    """
    if settings.barcode_enable_tiff_support:
        return {"application/pdf", "image/tiff"}
    return {"application/pdf"}
 def read_barcodes_zxing(image: Image.Image) -> list[tuple[str, str]]:
    """
    Returns the text and format (zxing enum name) of each barcode found in
    the image
    """
    barcodes = []
    import zxingcpp
    detected_barcodes = zxingcpp.read_barcodes(image)
    for barcode in detected_barcodes:
        if barcode.text:
            barcodes.append((barcode.text, barcode.format.name))
            logger.debug(
                f"Barcode of type {barcode.format} found: {barcode.text}",
            )
    return barcodes
 def scan_pdf(pdf_path: Path, settings: BarcodeConfig, work_dir: Path) -> list[Barcode]:
    """
    Scans the pages of a PDF as images for barcodes. Errors are not caught,
    so callers can tell a failed scan from one that found nothing.
    """
    barcodes: list[Barcode] = []
    with Pdf.open(pdf_path) as pdf:
        num_of_pages = len(pdf.pages)
    logger.debug(f"PDF has {num_of_pages} pages")
    # Get limit from configuration
    barcode_max_pages: int = (
        num_of_pages if settings.barcode_max_pages == 0 else settings.barcode_max_pages
    )
    if barcode_max_pages < num_of_pages:  # pragma: no cover
        logger.debug(
            f"Barcodes detection will be limited to the first {barcode_max_pages} pages",
        )
    for current_page_number in range(min(num_of_pages, barcode_max_pages)):
        logger.debug(f"Processing page {current_page_number}")
        # Convert page to image
        page = convert_from_path(
            pdf_path,
            dpi=settings.barcode_dpi,
            output_folder=work_dir,
            first_page=current_page_number + 1,
            last_page=current_page_number + 1,
        )[0]
        # Remember filename, since it is lost by upscaling
        page_filepath = Path(page.filename)
        logger.debug(f"Image is at {page_filepath}")
        # Upscale image if configured
        factor = settings.barcode_upscale
        if factor > 1.0:
            logger.debug(
                f"Upscaling image by {factor} for better barcode detection",
            )
            x, y = page.size
            page = page.resize(
                (round(x * factor), (round(y * factor))),
            )
        for barcode_value, barcode_format in read_barcodes_zxing(page):
            barcodes.append(
                Barcode(current_page_number, barcode_value, settings, barcode_format),
            )
        # Delete temporary image file
        page_filepath.unlink()
    return barcodes
 def read_barcode_values(
    path: Path,
    mime_type: str,
    settings: BarcodeConfig,
    work_dir: Path,
 ) -> list[StoredBarcode] | None:
    """
    Reads the barcodes of a file outside of the consumption plugins: for new
    versions, which skip the barcode plugin, and when reprocessing.
    Returns None if the file can't be scanned with the current settings.
    Errors while scanning are raised.
    """
    if mime_type not in scannable_mime_types(settings):
        return None
    if mime_type == "image/tiff":
        path = convert_from_tiff_to_pdf(path, work_dir)
    return [x.stored() for x in scan_pdf(path, settings, work_dir)]
@@ -18,6 +18,7 @@ from django.utils import timezone
 from filelock import FileLock
 from rest_framework.reverse import reverse
 from documents.barcodes import read_barcode_values
 from documents.classifier import load_classifier
 from documents.data_models import ConsumableDocument
 from documents.data_models import ConsumeFileSuccessResult
@@ -31,6 +32,7 @@ from documents.models import Correspondent
 from documents.models import CustomField
 from documents.models import CustomFieldInstance
 from documents.models import Document
 from documents.models import DocumentBarcode
 from documents.models import DocumentType
 from documents.models import StoragePath
 from documents.models import Tag
@@ -53,6 +55,7 @@ from documents.utils import compute_checksum
 from documents.utils import copy_basic_file_stats
 from documents.utils import copy_file_with_basic_stats
 from documents.utils import run_subprocess
 from paperless.config import BarcodeConfig
 from paperless.config import OcrConfig
 from paperless.config import RemoteOCRConfig
 from paperless.models import ArchiveFileGenerationChoices
@@ -504,6 +507,13 @@ class ConsumerPlugin(
                    f"Parser: {document_parser.name} v{document_parser.version}",
                )
                # New versions skip the barcode plugin, so read their barcodes here
                if (
                    self.input_doc.root_document_id is not None
                    and self.metadata.barcodes is None
                ):
                    self._read_version_barcodes(mime_type, Path(tmpdir))
                # Parse the document. This may take some time.
                text = None
@@ -631,6 +641,8 @@ class ConsumerPlugin(
                            else:
                                original_document.save()
                            self._store_barcodes(original_document)
                            # Adding a version changes the effective document, so update root modified
                            Document.objects.filter(pk=root_doc.pk).update(
                                modified=timezone.now(),
@@ -962,6 +974,32 @@ class ConsumerPlugin(
                }
                CustomFieldInstance.objects.create(**args)  # adds to document
        self._store_barcodes(document)
    def _read_version_barcodes(self, mime_type: str, work_dir: Path) -> None:
        barcode_settings = BarcodeConfig()
        if not barcode_settings.barcode_store_values:
            return
        try:
            self.metadata.barcodes = (
                read_barcode_values(
                    self.working_copy,
                    mime_type,
                    barcode_settings,
                    work_dir,
                )
                or None
            )
        except Exception as e:
            self.log.warning(f"Could not read barcodes of {self.filename}: {e}")
    def _store_barcodes(self, document: Document) -> None:
        if self.metadata.barcodes:
            DocumentBarcode.objects.bulk_create(
                DocumentBarcode(document=document, **barcode)
                for barcode in self.metadata.barcodes
            )
    def _write(self, source, target) -> None:
        with (
            Path(source).open("rb") as read_file,
@@ -9,6 +9,16 @@ from guardian.shortcuts import get_groups_with_perms
 from guardian.shortcuts import get_users_with_perms
 class StoredBarcode(TypedDict):
    """
    A detected barcode as it is stored with a document
    """
    page: int  # 1-indexed
    value: str
    format: str  # a DocumentBarcode.Format value
@dataclasses.dataclass
 class DocumentMetadataOverrides:
    """
@@ -35,6 +45,7 @@ class DocumentMetadataOverrides:
    version_label: str | None = None
    actor_id: int | None = None
    remote_ocr: bool = False
    barcodes: list[StoredBarcode] | None = None
    def update(self, other: "DocumentMetadataOverrides") -> "DocumentMetadataOverrides":
        """
@@ -45,6 +45,7 @@ from documents.models import Correspondent
 from documents.models import CustomField
 from documents.models import CustomFieldInstance
 from documents.models import Document
 from documents.models import DocumentBarcode
 from documents.models import DocumentType
 from documents.models import Note
 from documents.models import SavedView
@@ -353,6 +354,7 @@ class Command(CryptMixin, PaperlessCommand):
            "workflows": Workflow.objects.all(),
            "custom_fields": CustomField.objects.all(),
            "custom_field_instances": CustomFieldInstance.global_objects.all(),
            "document_barcodes": DocumentBarcode.objects.all(),
            "app_configs": ApplicationConfiguration.objects.all(),
            "notes": Note.global_objects.all(),
            "documents": Document.global_objects.order_by("id").all(),
@@ -411,6 +413,7 @@ class Command(CryptMixin, PaperlessCommand):
                    elif self.split_manifest and key in (
                        "notes",
                        "custom_field_instances",
                        "document_barcodes",
                    ):
                        # Written per-document in _write_split_manifest
                        pass
@@ -651,6 +654,12 @@ class Command(CryptMixin, PaperlessCommand):
                CustomFieldInstance.global_objects.filter(document=document),
            ),
        )
        content.extend(
            serializers.serialize(
                "python",
                DocumentBarcode.objects.filter(document=document),
            ),
        )
        manifest_name = base_name.with_name(f"{base_name.stem}-manifest.json")
        if self.use_folder_prefix:
            manifest_name = Path("json") / manifest_name
@@ -77,6 +77,8 @@ class Command(PaperlessCommand):
                    "notes__user",
                    "custom_fields__field",
                    "versions",
                    "barcodes",
                    "versions__barcodes",
                )
                total = documents.count()
                rebuild_kwargs = {}
@@ -0,0 +1,102 @@
 # Generated by Django 5.2.16 on 2026-09-30 23:01
 import django.db.models.deletion
 from django.db import migrations
 from django.db import models
 class Migration(migrations.Migration):
    dependencies = [
        ("documents", "0026_alter_document_archive_checksum_and_more"),
    ]
    operations = [
        migrations.CreateModel(
            name="DocumentBarcode",
            fields=[
                (
                    "id",
                    models.AutoField(
                        auto_created=True,
                        primary_key=True,
                        serialize=False,
                        verbose_name="ID",
                    ),
                ),
                (
                    "page",
                    models.PositiveIntegerField(
                        help_text="Page of the original file, starting at 1",
                        verbose_name="page",
                    ),
                ),
                ("value", models.TextField(verbose_name="value")),
                (
                    "format",
                    models.CharField(
                        choices=[
                            ("Codabar", "Codabar"),
                            ("Code39", "Code 39"),
                            ("Code39Std", "Code 39 Standard"),
                            ("Code39Ext", "Code 39 Extended"),
                            ("Code32", "Code 32"),
                            ("PZN", "Pharmazentralnummer"),
                            ("Code93", "Code 93"),
                            ("Code128", "Code 128"),
                            ("ITF", "ITF"),
                            ("ITF14", "ITF-14"),
                            ("DataBar", "DataBar"),
                            ("DataBarOmni", "DataBar Omni"),
                            ("DataBarStk", "DataBar Stacked"),
                            ("DataBarStkOmni", "DataBar Stacked Omni"),
                            ("DataBarLtd", "DataBar Limited"),
                            ("DataBarExp", "DataBar Expanded"),
                            ("DataBarExpStk", "DataBar Expanded Stacked"),
                            ("EANUPC", "EAN/UPC"),
                            ("EAN13", "EAN-13"),
                            ("EAN8", "EAN-8"),
                            ("EAN5", "EAN-5"),
                            ("EAN2", "EAN-2"),
                            ("ISBN", "ISBN"),
                            ("UPCA", "UPC-A"),
                            ("UPCE", "UPC-E"),
                            ("Telepen", "Telepen"),
                            ("TelepenAlpha", "Telepen Alpha"),
                            ("TelepenNumeric", "Telepen Numeric"),
                            ("OtherBarcode", "Other barcode"),
                            ("DXFilmEdge", "DX Film Edge"),
                            ("PDF417", "PDF417"),
                            ("CompactPDF417", "Compact PDF417"),
                            ("MicroPDF417", "MicroPDF417"),
                            ("Aztec", "Aztec"),
                            ("AztecCode", "Aztec Code"),
                            ("AztecRune", "Aztec Rune"),
                            ("QRCode", "QR Code"),
                            ("QRCodeModel1", "QR Code Model 1"),
                            ("QRCodeModel2", "QR Code Model 2"),
                            ("MicroQRCode", "Micro QR Code"),
                            ("RMQRCode", "rMQR Code"),
                            ("DataMatrix", "Data Matrix"),
                            ("MaxiCode", "MaxiCode"),
                        ],
                        max_length=32,
                        verbose_name="format",
                    ),
                ),
                (
                    "document",
                    models.ForeignKey(
                        on_delete=django.db.models.deletion.CASCADE,
                        related_name="barcodes",
                        to="documents.document",
                        verbose_name="document",
                    ),
                ),
            ],
            options={
                "verbose_name": "document barcode",
                "verbose_name_plural": "document barcodes",
                "ordering": ("page", "id"),
            },
        ),
    ]
@@ -366,6 +366,16 @@ class Document(SoftDeleteModel, ModelWithOwner):  # type: ignore[django-manager-
            res += f" {self.title}"
        return res
    def get_effective_barcodes(self) -> list["DocumentBarcode"]:
        """
        Returns the stored barcodes for the document, like
        get_effective_content(): for root documents those of the latest
        version when there is one, as that is the file users see.
        """
        from documents.versioning import latest_version
        return list(latest_version(self).barcodes.all())
    def get_effective_content(self) -> str | None:
        """
        Returns the effective content for the document.
@@ -969,6 +979,87 @@ class Note(SoftDeleteModel):
        return self.note
 class DocumentBarcode(models.Model):
    """
    A barcode found in a document during consumption, kept so its content
    can be shown and copied
    """
    document = models.ForeignKey(
        Document,
        related_name="barcodes",
        on_delete=models.CASCADE,
        verbose_name=_("document"),
    )
    page = models.PositiveIntegerField(
        _("page"),
        help_text=_("Page of the original file, starting at 1"),
    )
    value = models.TextField(_("value"))
    class Format(models.TextChoices):
        """
        The concrete barcode formats of zxing-cpp, keyed on the enum name.
        The labels are symbology names and aren't translated.
        """
        CODABAR = "Codabar", "Codabar"
        CODE39 = "Code39", "Code 39"
        CODE39_STD = "Code39Std", "Code 39 Standard"
        CODE39_EXT = "Code39Ext", "Code 39 Extended"
        CODE32 = "Code32", "Code 32"
        PZN = "PZN", "Pharmazentralnummer"
        CODE93 = "Code93", "Code 93"
        CODE128 = "Code128", "Code 128"
        ITF = "ITF", "ITF"
        ITF14 = "ITF14", "ITF-14"
        DATA_BAR = "DataBar", "DataBar"
        DATA_BAR_OMNI = "DataBarOmni", "DataBar Omni"
        DATA_BAR_STK = "DataBarStk", "DataBar Stacked"
        DATA_BAR_STK_OMNI = "DataBarStkOmni", "DataBar Stacked Omni"
        DATA_BAR_LTD = "DataBarLtd", "DataBar Limited"
        DATA_BAR_EXP = "DataBarExp", "DataBar Expanded"
        DATA_BAR_EXP_STK = "DataBarExpStk", "DataBar Expanded Stacked"
        EANUPC = "EANUPC", "EAN/UPC"
        EAN13 = "EAN13", "EAN-13"
        EAN8 = "EAN8", "EAN-8"
        EAN5 = "EAN5", "EAN-5"
        EAN2 = "EAN2", "EAN-2"
        ISBN = "ISBN", "ISBN"
        UPCA = "UPCA", "UPC-A"
        UPCE = "UPCE", "UPC-E"
        TELEPEN = "Telepen", "Telepen"
        TELEPEN_ALPHA = "TelepenAlpha", "Telepen Alpha"
        TELEPEN_NUMERIC = "TelepenNumeric", "Telepen Numeric"
        OTHER_BARCODE = "OtherBarcode", "Other barcode"
        DX_FILM_EDGE = "DXFilmEdge", "DX Film Edge"
        PDF417 = "PDF417", "PDF417"
        COMPACT_PDF417 = "CompactPDF417", "Compact PDF417"
        MICRO_PDF417 = "MicroPDF417", "MicroPDF417"
        AZTEC = "Aztec", "Aztec"
        AZTEC_CODE = "AztecCode", "Aztec Code"
        AZTEC_RUNE = "AztecRune", "Aztec Rune"
        QR_CODE = "QRCode", "QR Code"
        QR_CODE_MODEL1 = "QRCodeModel1", "QR Code Model 1"
        QR_CODE_MODEL2 = "QRCodeModel2", "QR Code Model 2"
        MICRO_QR_CODE = "MicroQRCode", "Micro QR Code"
        RMQR_CODE = "RMQRCode", "rMQR Code"
        DATA_MATRIX = "DataMatrix", "Data Matrix"
        MAXI_CODE = "MaxiCode", "MaxiCode"
    format = models.CharField(_("format"), max_length=32, choices=Format.choices)
    class Meta:
        ordering = ("page", "id")
        verbose_name = _("document barcode")
        verbose_name_plural = _("document barcodes")
    def __str__(self) -> str:  # pragma: no cover
        return self.value
 class ShareLink(SoftDeleteModel):
    class FileVersion(models.TextChoices):
        ARCHIVE = ("archive", _("Archive"))
@@ -311,7 +311,13 @@ class WriteBatch:
        queryset = annotate_effective_content(
            Document.objects.filter(pk__in=ids)
            .select_related("correspondent", "document_type", "storage_path", "owner")
-            .prefetch_related("tags", "notes__user", "custom_fields__field"),
+            .prefetch_related(
                "tags",
                "notes__user",
                "custom_fields__field",
                "barcodes",
                "versions__barcodes",
            ),
        )
        for document, grant in _DocumentViewerStream(queryset, chunk_size=1000):
            self.remove(document.pk)
@@ -604,6 +610,16 @@ class TantivyBackend:
                },
            )
        # Barcodes: JSON field like custom_fields, only filled when stored
        for barcode in document.get_effective_barcodes():
            doc.add_json(
                "barcodes",
                {
                    "value": normalize_search_text(barcode.value),
                    "format": normalize_search_text(barcode.format),
                },
            )
        # Dates
        created_date = datetime(
            document.created.year,
@@ -39,4 +39,9 @@ PUBLIC_FIELDS: tuple[FieldSpec, ...] = (
        FieldKind.JSON,
        subpaths={"name": SubpathSpec(), "value": SubpathSpec(default=True)},
    ),
    FieldSpec(
        "barcodes",
        FieldKind.JSON,
        subpaths={"value": SubpathSpec(default=True), "format": SubpathSpec()},
    ),
 )
@@ -25,7 +25,8 @@ logger = logging.getLogger("paperless.search")
 #      order, and the write-only correspondent/document_type/storage_path/tag id
 #      columns dropped. tantivy compares schemas by ordered field list, so an
 #      index built by v1 rejects every write against the v2 schema.
-SCHEMA_VERSION: Final[int] = 2
+# v3 - barcodes JSON field for stored barcode contents
 SCHEMA_VERSION: Final[int] = 3
 class FieldDescriptor(NamedTuple):
@@ -60,6 +60,7 @@ from documents.models import Correspondent
 from documents.models import CustomField
 from documents.models import CustomFieldInstance
 from documents.models import Document
 from documents.models import DocumentBarcode
 from documents.models import DocumentType
 from documents.models import MatchingModel
 from documents.models import Note
@@ -987,6 +988,12 @@ class BasicUserSerializer(serializers.ModelSerializer[User]):
        fields = ["id", "username", "first_name", "last_name"]
 class DocumentBarcodeSerializer(serializers.ModelSerializer[DocumentBarcode]):
    class Meta:
        model = DocumentBarcode
        fields = ["page", "value", "format"]
 class NotesSerializer(serializers.ModelSerializer[Note]):
    user = BasicUserSerializer(read_only=True)
@@ -20,6 +20,7 @@ from filelock import FileLock
 from documents import sanity_checker
 from documents.barcodes import BarcodePlugin
 from documents.barcodes import read_barcode_values
 from documents.bulk_download import ArchiveOnlyStrategy
 from documents.bulk_download import OriginalsOnlyStrategy
 from documents.caching import clear_document_caches
@@ -36,6 +37,7 @@ from documents.data_models import ConsumeFileDuplicateResult
 from documents.data_models import ConsumeFileStoppedResult
 from documents.data_models import ConsumeFileSuccessResult
 from documents.data_models import DocumentMetadataOverrides
 from documents.data_models import StoredBarcode
 from documents.double_sided import CollatePlugin
 from documents.file_handling import create_source_path_directory
 from documents.file_handling import generate_unique_filename
@@ -43,6 +45,7 @@ from documents.matching import prefilter_documents_by_workflowtrigger
 from documents.models import Correspondent
 from documents.models import CustomFieldInstance
 from documents.models import Document
 from documents.models import DocumentBarcode
 from documents.models import DocumentType
 from documents.models import PaperlessTask
 from documents.models import ShareLink
@@ -67,6 +70,7 @@ from documents.utils import identity
 from documents.versioning import annotate_effective_content
 from documents.workflows.utils import get_workflows_for_trigger
 from paperless.config import AIConfig
 from paperless.config import BarcodeConfig
 from paperless.config import RemoteOCRConfig
 from paperless.logging import consume_task_id
 from paperless.parsers import ParserContext
@@ -341,6 +345,29 @@ def bulk_update_documents(document_ids) -> None:
        )
 def _read_barcodes_for_reprocess(document: Document) -> list[StoredBarcode] | None:
    """
    Reads the barcodes of the original again, e.g. for documents consumed
    before storing them was enabled. Returns None if they should be left as
    they are: storing is off, the file can't be scanned with the current
    settings, or the scan failed.
    """
    barcode_settings = BarcodeConfig()
    if not barcode_settings.barcode_store_values:
        return None
    try:
        with TemporaryDirectory(dir=settings.SCRATCH_DIR) as tmpdir:
            return read_barcode_values(
                document.source_path,
                document.mime_type,
                barcode_settings,
                Path(tmpdir),
            )
    except Exception as e:
        logger.warning(f"Could not read barcodes of document {document}: {e}")
        return None
@shared_task
 def update_document_content_maybe_archive_file(
    document_id,
@@ -387,6 +414,8 @@ def update_document_content_maybe_archive_file(
                produce_archive=produce_archive,
            )
            barcodes = _read_barcodes_for_reprocess(document)
            thumbnail = parser.get_thumbnail(document.source_path, mime_type)
            with transaction.atomic():
@@ -443,6 +472,17 @@ def update_document_content_maybe_archive_file(
                            action=LogEntry.Action.UPDATE,
                        )
                if barcodes is not None:
                    document.barcodes.all().delete()
                    DocumentBarcode.objects.bulk_create(
                        DocumentBarcode(document=document, **barcode)
                        for barcode in barcodes
                    )
                    # metadata_etag includes modified
                    Document.objects.filter(pk=document.pk).update(
                        modified=timezone.now(),
                    )
                with FileLock(settings.MEDIA_LOCK):
                    if parser.get_archive_path():
                        create_source_path_directory(document.archive_path)
@@ -12,25 +12,29 @@ if TYPE_CHECKING:
    from paperless_testing.dirs import PaperlessDirs
@pytest.fixture(scope="session")
 def document_samples_dir() -> Path:
    """Path to the shared test sample documents."""
    return Path(__file__).parent / "samples" / "documents"
@pytest.fixture()
 def sample_doc(
    paperless_dirs: "PaperlessDirs",
-    simple_digital_pdf_file: Path,
+    document_samples_dir: Path,
    multi_page_images_pdf_file: Path,
    thumbnail_webp_file: Path,
 ) -> "Document":
    """Create a document with valid files and matching checksums."""
    with filelock.FileLock(paperless_dirs.media_lock):
        shutil.copy(
-            simple_digital_pdf_file,
+            document_samples_dir / "originals" / "0000001.pdf",
            paperless_dirs.originals_dir / "0000001.pdf",
        )
        shutil.copy(
-            multi_page_images_pdf_file,
+            document_samples_dir / "archive" / "0000001.pdf",
            paperless_dirs.archive_dir / "0000001.pdf",
        )
        shutil.copy(
-            thumbnail_webp_file,
+            document_samples_dir / "thumbnails" / "0000001.webp",
            paperless_dirs.thumbnail_dir / "0000001.webp",
        )
@@ -0,0 +1 @@
 This is a test file.
@@ -0,0 +1,95 @@
 """Stored barcode contents in the search index.
 Barcodes are a JSON field like notes and custom fields: barcodes: resolves to
 barcodes.value:, and a plain query without the prefix does not look at them.
 """
 from __future__ import annotations
 from typing import TYPE_CHECKING
 import pytest
 from documents.models import DocumentBarcode
 from paperless_testing.factories import DocumentBarcodeFactory
 from paperless_testing.factories import DocumentFactory
 if TYPE_CHECKING:
    from collections.abc import Callable
    from documents.models import Document
    from documents.search._backend import TantivyBackend
 pytestmark = [pytest.mark.search, pytest.mark.django_db]
 class TestBarcodeSearch:
    @pytest.fixture
    def with_barcodes(self, backend: TantivyBackend) -> Document:
        document = DocumentFactory(title="Letter", content="x")
        DocumentBarcodeFactory(
            document=document,
            value="WIFI:T:WPA;S:Guest-WLAN;P:crocodile123;;",
        )
        DocumentBarcodeFactory(
            document=document,
            page=2,
            value="DE89370400440532013000",
            format=DocumentBarcode.Format.CODE128,
        )
        backend.add_or_update(document)
        return document
    def test_bare_barcodes_prefix_searches_values(
        self,
        with_barcodes: Document,
        index_document: Callable[..., Document],
        matched_ids: Callable[[str], set[int]],
    ) -> None:
        """
        GIVEN:
            - A document with stored barcodes, and a decoy document whose
              content (not a barcode) contains the same word
        WHEN:
            - A bare "barcodes:" prefix query is run
        THEN:
            - Only the document whose barcode matches is returned, also for a
              part of a barcode between separators
        """
        index_document(title="Decoy", content="crocodile123 in the text")
        assert matched_ids("barcodes:crocodile123") == {with_barcodes.pk}
        assert matched_ids("barcodes.value:DE89370400440532013000") == {
            with_barcodes.pk,
        }
    def test_barcodes_format_subpath(
        self,
        with_barcodes: Document,
        matched_ids: Callable[[str], set[int]],
    ) -> None:
        """
        GIVEN:
            - A document with a QR code and a Code 128 barcode
        WHEN:
            - The format subpath is queried
        THEN:
            - The document is found by its barcode formats
        """
        assert matched_ids("barcodes.format:qrcode") == {with_barcodes.pk}
        assert matched_ids("barcodes.format:aztec") == set()
    def test_plain_query_ignores_barcodes(
        self,
        with_barcodes: Document,
        matched_ids: Callable[[str], set[int]],
    ) -> None:
        """
        GIVEN:
            - A document with a barcode value not found in its text
        WHEN:
            - The value is searched without a field prefix
        THEN:
            - Nothing is found, as with notes and custom fields
        """
        assert matched_ids("crocodile123") == set()
@@ -8,7 +8,7 @@ queryable-but-always-empty -- syntactically valid, silently matching
 nothing -- with no test failure anywhere.
 This indexes one real document carrying values for every JSON field
-(a Note, a CustomFieldInstance) and inspects the document's own stored
+(a Note, a CustomFieldInstance, a DocumentBarcode) and inspects the document's own stored
 JSON payload, rather than running field-specific queries: that way a
 future JSON field's subpaths are covered automatically, without a new
 per-subpath query having to be added by hand each time.
@@ -27,6 +27,7 @@ from documents.models import CustomFieldInstance
 from documents.models import Document
 from documents.models import Note
 from documents.search._fields import PUBLIC_FIELDS
 from paperless_testing.factories import DocumentBarcodeFactory
 from paperless_testing.factories import UserFactory
 if TYPE_CHECKING:
@@ -42,11 +43,12 @@ class TestJsonSubpathsAreWrittenAtIndexTime:
    ) -> None:
        """
        GIVEN:
-            - A document with a Note and a CustomFieldInstance attached
+            - A document with a Note, a CustomFieldInstance and a
              DocumentBarcode attached
        WHEN:
            - The document is indexed via TantivyBackend.add_or_update
        THEN:
-            - Every subpath PUBLIC_FIELDS declares for notes/custom_fields
+            - Every subpath PUBLIC_FIELDS declares for notes/custom_fields/barcodes
              is present as a key in the document's stored JSON payload
        """
        user = UserFactory(username="completeness-user")
@@ -65,6 +67,7 @@ class TestJsonSubpathsAreWrittenAtIndexTime:
            field=field,
            value_text="a value",
        )
        DocumentBarcodeFactory(document=doc, value="a barcode")
        backend.add_or_update(doc)
        index = backend._index
@@ -175,6 +175,14 @@ PINNED_DESCRIPTORS: tuple[FieldDescriptor, ...] = (
        fast=False,
        tokenizer="paperless_text",
    ),
    FieldDescriptor(
        "barcodes",
        "json",
        stored=True,
        indexed=True,
        fast=False,
        tokenizer="paperless_text",
    ),
    FieldDescriptor(
        "title_sort",
        "text",
@@ -74,6 +74,7 @@ class TestApiAppConfig(DirectoriesMixin, APITestCase):
                "barcode_enable_tag": None,
                "barcode_tag_mapping": None,
                "barcode_tag_split": None,
                "barcode_store_values": None,
                "remote_ocr_engine": None,
                "remote_ocr_api_key": None,
                "remote_ocr_endpoint": None,
@@ -53,7 +53,7 @@ class TestBulkDownload(DirectoriesMixin, SampleDirMixin, APITestCase):
            archive_checksum="D",
        )
-        shutil.copy(self.SIMPLE_PDF, self.doc2.source_path)
+        shutil.copy(self.SAMPLE_DIR / "simple.pdf", self.doc2.source_path)
        shutil.copy(self.SAMPLE_DIR / "simple.png", self.doc2b.source_path)
        shutil.copy(self.SAMPLE_DIR / "simple.jpg", self.doc3.source_path)
        shutil.copy(self.SAMPLE_DIR / "test_with_bom.pdf", self.doc3.archive_path)
@@ -56,8 +56,6 @@ from paperless_testing.http import read_streaming_response
 from paperless_testing.permissions import grant_all_global
 from paperless_testing.permissions import grant_global
 from paperless_testing.permissions import grant_object
 from paperless_testing.samples import SIMPLE_DIGITAL_PDF
 from paperless_testing.samples import THUMBNAIL_WEBP
 class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
@@ -1854,11 +1852,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SimpleUploadedFile(
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            "simple.pdf",
            SIMPLE_DIGITAL_PDF.read_bytes(),
            content_type="application/pdf",
        ) as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f},
@@ -1886,7 +1880,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
        payload = SimpleUploadedFile(
            "../../outside.pdf",
-            SIMPLE_DIGITAL_PDF.read_bytes(),
+            (Path(__file__).parent / "samples" / "simple.pdf").read_bytes(),
            content_type="application/pdf",
        )
@@ -1915,7 +1909,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        pdf_bytes = SIMPLE_DIGITAL_PDF.read_bytes()
+        pdf_bytes = (Path(__file__).parent / "samples" / "simple.pdf").read_bytes()
        boundary = "paperless-boundary"
        payload = (
            (
@@ -1991,7 +1985,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
    def test_upload_insufficient_permissions(self) -> None:
        self.client.force_authenticate(user=UserFactory(username="testuser2"))
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f},
@@ -2004,11 +1998,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SimpleUploadedFile(
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            "simple.pdf",
            SIMPLE_DIGITAL_PDF.read_bytes(),
            content_type="application/pdf",
        ) as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {
@@ -2041,7 +2031,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"documenst": f},
@@ -2067,7 +2057,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "title": "my custom title"},
@@ -2087,7 +2077,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
        )
        c = Correspondent.objects.create(name="test-corres")
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "correspondent": c.id},
@@ -2106,7 +2096,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "correspondent": 3456},
@@ -2121,7 +2111,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
        )
        dt = DocumentType.objects.create(name="invoice")
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "document_type": dt.id},
@@ -2140,7 +2130,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "document_type": 34578},
@@ -2155,7 +2145,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
        )
        sp = StoragePath.objects.create(name="invoices")
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "storage_path": sp.id},
@@ -2174,7 +2164,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "storage_path": 34578},
@@ -2190,7 +2180,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
        t1 = Tag.objects.create(name="tag1")
        t2 = Tag.objects.create(name="tag2")
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "tags": [t2.id, t1.id]},
@@ -2211,7 +2201,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
        t1 = Tag.objects.create(name="tag1")
        t2 = Tag.objects.create(name="tag2")
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "tags": [t2.id, t1.id, 734563]},
@@ -2235,7 +2225,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            0,
            tzinfo=zoneinfo.ZoneInfo("America/Los_Angeles"),
        )
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "created": created},
@@ -2251,11 +2241,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SimpleUploadedFile(
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            "simple.pdf",
            SIMPLE_DIGITAL_PDF.read_bytes(),
            content_type="application/pdf",
        ) as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "archive_serial_number": 500},
@@ -2282,11 +2268,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            data_type=CustomField.FieldDataType.STRING,
        )
-        with SimpleUploadedFile(
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            "simple.pdf",
            SIMPLE_DIGITAL_PDF.read_bytes(),
            content_type="application/pdf",
        ) as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {
@@ -2341,7 +2323,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
        w1.actions.add(action1)
        w1.save()
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {
@@ -2382,11 +2364,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            data_type=CustomField.FieldDataType.INT,
        )
-        with SimpleUploadedFile(
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            "simple.pdf",
            SIMPLE_DIGITAL_PDF.read_bytes(),
            content_type="application/pdf",
        ) as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {
@@ -2435,7 +2413,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
        ]
        for payload in error_payloads:
-            with SIMPLE_DIGITAL_PDF.open("rb") as f:
+            with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
                data = {"document": f, **payload}
                response = self.client.post(
                    "/api/documents/post_document/",
@@ -2493,7 +2471,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            id=str(uuid.uuid4()),
        )
-        with SIMPLE_DIGITAL_PDF.open("rb") as f:
+        with (Path(__file__).parent / "samples" / "simple.pdf").open("rb") as f:
            response = self.client.post(
                "/api/documents/post_document/",
                {"document": f, "from_webui": True},
@@ -2532,8 +2510,14 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            archive_filename="archive.pdf",
        )
-        source_file: Path = THUMBNAIL_WEBP
+        source_file: Path = (
-        archive_file: Path = SIMPLE_DIGITAL_PDF
+            Path(__file__).parent
            / "samples"
            / "documents"
            / "thumbnails"
            / "0000001.webp"
        )
        archive_file: Path = Path(__file__).parent / "samples" / "simple.pdf"
        shutil.copy(source_file, doc.source_path)
        shutil.copy(archive_file, doc.archive_path)
@@ -2566,7 +2550,7 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            mime_type="application/pdf",
        )
-        shutil.copy(SIMPLE_DIGITAL_PDF, doc.source_path)
+        shutil.copy(Path(__file__).parent / "samples" / "simple.pdf", doc.source_path)
        response = self.client.get(f"/api/documents/{doc.pk}/metadata/")
        self.assertEqual(response.status_code, status.HTTP_200_OK)
@@ -4304,8 +4288,8 @@ class TestDocumentApi(DirectoriesMixin, ConsumeTaskMixin, APITestCase):
            filename="test2.pdf",
        )
-        archive_file = SIMPLE_DIGITAL_PDF
+        archive_file = Path(__file__).parent / "samples" / "simple.pdf"
-        source_file = SIMPLE_DIGITAL_PDF
+        source_file = Path(__file__).parent / "samples" / "simple.pdf"
        shutil.copy(archive_file, doc.archive_path)
        shutil.copy(source_file, doc2.source_path)
Author	SHA1	Message	Date
shamoon	6f7ed1d4a7	Bump version to 3.3.0	2026-10-05 20:34:24 -07:00
shamoon	0428bf6955	Merge branch 'dev'	2026-10-05 20:33:36 -07:00
github-actions[bot]andCrowdin Bot	662a5237a3	New Crowdin translations by GitHub Action (#14361 ) Co-authored-by: Crowdin Bot <support+bot@crowdin.com>	2026-10-06 03:29:47 +00:00
GitHub Actions	562c2d0985	Auto translate strings	2026-10-06 03:19:38 +00:00
shamoon	6cdb93cd59	Fix: dont overcount same title or date suggestions	2026-10-05 20:18:09 -07:00
GitHub Actions	85fcf66691	Auto translate strings	2026-10-06 03:05:53 +00:00
shamoon	73b2321e87	Fix create after ML-only	2026-10-05 20:04:35 -07:00
GitHub Actions	5eecd6971e	Auto translate strings	2026-10-06 02:34:22 +00:00
shamoon	bc92e4ff98	Fix suggestions dropdown counts and empty state	2026-10-05 19:32:56 -07:00
github-actions[bot]andCrowdin Bot	dacc213917	New Crowdin translations by GitHub Action (#14214 ) Co-authored-by: Crowdin Bot <support+bot@crowdin.com>	2026-10-06 02:09:40 +00:00
GitHub Actions	c780586c72	Auto translate strings	2026-10-05 16:26:46 +00:00
jurassicparkicecreamandshamoon	62cc31fbdb	Feature: store barcode contents, list and search them (#14276 ) * Feature: store barcode contents, list and search them New setting PAPERLESS_CONSUMER_STORE_BARCODE_VALUES (off by default) stores all barcodes found during consumption with the document: page, type and content. They are listed on the metadata tab with a copy button, returned by the documents API and searchable with barcodes: in the advanced search. Versions keep their own barcodes, reprocessing reads them again. Refs #9898 * Tests: cover the remaining barcode branches Covers unchanged and failing barcode reads on reprocessing, unsupported files and DocumentBarcode.__str__, and uses toHaveLength in the barcode list spec as suggested by SonarCloud. * Address review: keep barcodes when they can't be read, format choices - Reprocessing and new versions keep the stored barcodes when the file can't be scanned or the scan fails, and replace them atomically. - Format is a TextChoices of the zxing-cpp formats, with a test. - Shared scan code, latest_version helper, TypedDict, serializer reuse. - Barcodes in the split manifest, export/import tests, pytest-style tests. * Barcode tests: TIFF reprocess, format check both ways, fixtures - Reprocessing a TIFF with TIFF support off keeps the stored barcodes. - The format test also fails when zxing-cpp drops a format. - Fixtures in place of the sample dir mixin, plugin-level disabled test. - Format labels aren't translated, OpenAPI enum named BarcodeFormatEnum. * Review: module-level zxing reader, shorter barcode docs - read_barcodes_zxing is a module-level function used by scan_pdf. - Drop the trivial __str__ test, mark it no cover. - Shorten the barcode docs and remove the duplicate in configuration.md. * Fix header * Use utility class * Return barcodes from the metadata endpoint only Drop the barcodes field and its prefetches from the document serializer, as agreed in the review. Also remove the now empty component stylesheet. --------- Co-authored-by: shamoon <4887959+shamoon@users.noreply.github.com>	2026-10-05 16:25:19 +00:00
Trenton H	312684aef3	Fix: Set the ProcessedMail owner based on the rule owner in all cases (#14356 )	2026-10-05 05:57:41 -07:00
dependabot[bot]andTrenton H	1d42d372a2	Chore(deps): Bump django-filter from 25.2 to 26.1 (#14337 ) * Chore(deps): Bump django-filter from 25.2 to 26.1 Bumps [django-filter](https://github.com/carltongibson/django-filter) from 25.2 to 26.1. - [Release notes](https://github.com/carltongibson/django-filter/releases) - [Changelog](https://github.com/carltongibson/django-filter/blob/main/CHANGES.rst) - [Commits](https://github.com/carltongibson/django-filter/compare/25.2...26.1) --- updated-dependencies: - dependency-name: django-filter dependency-version: '26.1' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> * Linting --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Trenton H <797416+stumpylog@users.noreply.github.com>	2026-10-04 22:24:13 +00:00
dependabot[bot]	08c4f3d3aa	Chore(deps): Bump the utilities-patch group across 1 directory with 2 updates (#14338 ) Bumps the utilities-patch group with 2 updates in the / directory: [psycopg-pool](https://github.com/psycopg/psycopg) and [ruff](https://github.com/astral-sh/ruff). Updates `psycopg-pool` from 3.3.2 to 3.3.3 - [Changelog](https://github.com/psycopg/psycopg/blob/master/docs/news.rst) - [Commits](https://github.com/psycopg/psycopg/compare/3.3.2...3.3.3) Updates `ruff` from 0.16.8 to 0.16.9 - [Release notes](https://github.com/astral-sh/ruff/releases) - [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md) - [Commits](https://github.com/astral-sh/ruff/compare/0.16.8...0.16.9) --- updated-dependencies: - dependency-name: psycopg-pool dependency-version: 3.3.3 dependency-type: direct:production update-type: version-update:semver-patch dependency-group: utilities-patch - dependency-name: ruff dependency-version: 0.16.9 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: utilities-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2026-10-04 13:54:08 -07:00
shamoon	c63afb47b2	Documentation: correct duplicates info (#14243 )	2026-09-23 08:27:18 -07:00