amorfo77/paperless-ngx
1
0
Fork 0
mirror of https://github.com/paperless-ngx/paperless-ngx.git synced 2026-08-20 09:43:29 +00:00
Code Issues Projects Releases Wiki Activity

docs: clarify quoted date-keyword phrases and dropped *_id field aliases

Browse Source 
Add a sentence to the "Supported date keywords" advanced-search section
noting that multi-word date keywords must be quoted (e.g.
added:"previous month") -- whoosh-compat requires quoting where the
unquoted form used to work. Also document that the old undocumented
*_id field aliases (tag_id, owner_id, viewer_id, correspondent_id,
document_type_id, storage_path_id, type_id, path_id) are no longer
recognized: a query using one now silently folds to a literal-text
search instead of matching the intended structured field.
This commit is contained in:
Trenton Holmes
2026-08-19 13:36:53 -07:00
committed by stumpylog
parent 35917be2d4
commit 943e60fecc
1 changed files with 11 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/usage.md
+11
View File
@@ -919,6 +919,14 @@ original_filename:invoice.pdf
- `original_filename` matches the filename of the document as originally
consumed.
Older, undocumented `*_id` field prefixes (`tag_id`, `owner_id`, `viewer_id`,
`correspondent_id`, `document_type_id`, `storage_path_id`, `type_id`, and
`path_id`) are no longer recognized advanced-search fields. A query using one
of them (e.g. `tag_id:5`) does not error; it silently falls back to a literal
text search for that string, which will almost never match real document
content. Use the corresponding named field (`tag`, `correspondent`,
`document_type`, etc.) instead.
Matching inexact words:
```
@@ -927,6 +935,9 @@ produ*name
Matching natural date keywords:
Multi-word date keywords must be quoted (e.g. `added:"previous month"`); an
unquoted multi-word keyword is not recognized as a date keyword.
```
added:today
modified:yesterday