For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

For a complete list of changes, see the changelog at https://paperless-ng.readthedocs.io/en/latest/changelog.html.

• Fixed an issue with Paperless not starting due to the new Tika integration when USERMAP_UID and USERMAP_GID was used in the docker-compose.env file.

• Paperless localization

  • Thanks to the combined efforts of many users, Paperless is now available in English, Dutch, French and German.

• Thanks to Jo Vandeginste, Paperless has optional support for Office documents such as .docx, .doc, .odt and more.

  • See https://paperless-ng.readthedocs.io/en/latest/configuration.html#tika-settings on how to enable this feature. This feature requires two additional services (one for parsing Office documents and metadata extraction and another for converting Office documents to PDF), and is therefore not enabled on default installations.
  • As with all other documents, paperless converts Office documents to PDF and stores both the original as well as the archived PDF.

• Dark mode

  • Thanks to Michael Shamoon, paperless now has a dark mode. Configuration is available in the settings.

• Other changes and additions

  • The PDF viewer now uses a local copy of some dependencies instead of fetching them from the internet. Thanks to slorenz.
  • Revamped search bar styling thanks to Michael Shamoon.
  • Sorting in the document list by clicking on table headers.
  • A button was added to the document detail page that assigns a new ASN to a document.
  • Form field validation: When providing invalid input in a form (such as a duplicate ASN or no name), paperless now has visual indicators and clearer error messages about what's wrong.
  • Paperless disables buttons with network actions (such as save and delete) when a network action is active. This indicates that something is happening and prevents double clicking.
  • When using "Save & next", the title field is focussed automatically to better support keyboard editing.
  • E-Mail: Added filter rule parameters to allow inline attachments (watch out for mails with inlined images!) and attachment filename filters with wildcards.
  • Support for remote user authentication thanks to Michael Shamoon. This is useful for hiding Paperless behind single sign on applications such as authelia https://www.authelia.com/.
  • "Clear filters" has been renamed to "Reset filters" and now correctly restores the default filters on saved views. Thanks to Michael Shamoon.

• Fixes

  • Paperless was unable to save views when "Not assigned" was chosen in one of the filter dropdowns.
  • Clearer error messages when pre and post consumption scripts do not exist.
  • The post consumption script is executed later in the consumption process. Before the change, an ID was passed to the script referring to a document that did not yet exist in the database.

• Fixed an issue with the docker image not starting at all due to a configuration change of the web server.

• Bulk editing

  • Thanks to Michael Shamoon, we've got a new interface for the bulk editor.
  • There are some configuration options in the settings to alter the behavior.

• Other changes and additions

  • Thanks to zjean, paperless now publishes a webmanifest, which is useful for adding the application to home screens on mobile devices.
  • The Paperless-ng logo now navigates to the dashboard.
  • Filter for documents that don't have any correspondents, types or tags assigned.
  • Tags, types and correspondents are now sorted case insensitive.
  • Lots of preparation work for localization support.

• Fixes

  • Added missing dependencies for Raspberry Pi builds.
  • Fixed an issue with plain text file consumption: Thumbnail generation failed due to missing fonts.
  • An issue with the search index reporting missing documents after bulk deletes was fixed.
  • Issue with the tag selector not clearing input correctly.
  • The consumer used to stop working when encountering an incomplete classifier model file.

Note:

The bulk delete operations did not update the search index. Therefore, documents that you deleted remained in the index and caused the search to return messages about missing documents when searching. Further bulk operations will properly update the index.

However, this change is not retroactive: If you used the delete method of the bulk editor, you need to reindex your search index by running the management command document_index with the argument reindex.

Christmas release!

• Bulk editing

  • Paperless now supports bulk editing.
  • The following operations are available: Add and remove correspondents, tags, document types from selected documents, as well as mass-deleting documents.
  • We've got a more fancy UI in the works that makes these features more accessible, but that's not quite ready yet.

• Searching

  • Paperless now supports searching for similar documents ("More like this") both from the document detail page as well as from individual search results.
  • A search score indicates how well a document matches the search query, or how similar a document is to a given reference document.

• Other additions and changes

  • Clarification in the UI that the fields "Match" and "Is insensitive" are not relevant for the Auto matching algorithm.
  • New select interface for tags, types and correspondents allows filtering. This also improves tag selection. Thanks again to Michael Shamoon!
  • Page navigation controls for the document viewer, thanks to Michael Shamoon.
  • Layout changes to the small cards document list.
  • The dashboard now displays the username (or full name if specified in the admin) on the dashboard.

• Fixes

  • An error that caused the document importer to crash was fixed.
  • An issue with changes not being possible when PAPERLESS_COOKIE_PREFIX is used was fixed.
  • The date selection filters now allow manual entry of dates.

• Feature Removal

  • Most of the guesswork features have been removed. Paperless no longer tries to extract correspondents and tags from file names.

This release addresses two severe issues with the previous release.

• The delete buttons for document types, correspondents and tags were not working.
• The document section in the admin was causing internal server errors (500).

This release contained some issues with not being able to delete correspondents, tags or types and some issues with certain admin pages. Therefore, I've decided to remove this release. There's no need to downgrade. Changelog below.

• Front end

  • Thanks to the hard work of Michael Shamoon, paperless now comes with a much more streamlined UI for filtering documents.
  • Michael Shamoon replaced the document preview with another component. This should fix compatibility with Safari browsers.
  • Added buttons to the management pages to quickly show all documents with one specific tag, correspondent, or title.
  • Paperless now stores your saved views on the server and associates them with your user account. This means that you can access your views on multiple devices and have separate views for different users. You will have to recreate your views.
  • The GitHub and documentation links now open in new tabs/windows. Thanks to rYR79435.
  • Paperless now generates default saved view names when saving views with certain filter rules.
  • Added a small version indicator to the front end.

• Other additions and changes

  • The new filename format field {tag_list} inserts a list of tags into the filename, separated by comma.
  • The document_retagger no longer removes inbox tags or tags without matching rules.
  • The new configuration option PAPERLESS_COOKIE_PREFIX allows you to run multiple instances of paperless on different ports. This option enables you to be logged in into multiple instances by specifying different cookie names for each instance.

• Fixes

  • Sometimes paperless would assign dates in the future to newly consumed documents.
  • The filename format fields {created_month} and {created_day} now use a leading zero for single digit values.
  • The filename format field {tags} can no longer be used without arguments.
  • Paperless was not able to consume many images (especially images from mobile scanners) due to missing DPI information. Paperless now assumes A4 paper size for PDF generation if no DPI information is present.
  • Documents with empty titles could not be opened from the table view due to the link being empty.
  • Fixed an issue with filenames containing special characters such as : not being accepted for upload.
  • Fixed issues with thumbnail generation for plain text files.

This release focuses primarily on many small issues with the UI.

• Front end

  • Paperless now has proper window titles.
  • Fixed an issue with the small cards when more than 7 tags were used.
  • Navigation of the "Show all" links adjusted. They navigate to the saved view now, if available in the sidebar.
  • Some indication on the document lists that a filter is active was added.
  • There's a new filter to filter for documents that do not have a certain tag.
  • The file upload box now shows upload progress.
  • The document edit page was reorganized.
  • The document edit page shows various information about a document.
  • An issue with the height of the preview was fixed.
  • Table issues with too long document titles fixed.

• API

  • The API now serves file names with documents.
  • The API now serves various metadata about documents.
  • API documentation updated.

• Other

  • Fixed an issue with the docker image when a non-standard PostgreSQL port was used.
  • The docker image was trying check for installed languages before actually installing them.
  • FILENAME_FORMAT placeholder for document types.
  • The filename formatter is now less restrictive with file names and tries to conserve the original correspondents, types and titles as much as possible.
  • The filename formatter does not include the document ID in filenames anymore. It will rather append _01, _02, etc when it detects duplicate filenames.

Note:

The changes to the filename format will apply to newly added documents and changed documents. If you want all files to reflect these changes, execute the document_renamer management command.

This release concludes the big changes I wanted to get rolled into paperless. The next releases before 1.0 will focus on fixing issues, primarily.

• OCR

  • Paperless now uses OCRmyPDF to perform OCR on documents. It still uses tesseract under the hood, but the PDF parser of Paperless has changed considerably and will behave different for some douments.
  • OCRmyPDF creates archived PDF/A documents with embedded text that can be selected in the front end.
  • Paperless stores archived versions of documents alongside with the originals. The originals can be accessed on the document edit page. If available, a dropdown menu will appear next to the download button.
  • Many of the configuration options regarding OCR have changed. See the documentation for details.
  • Paperless no longer guesses the language of your documents. It always uses the language that you specified with PAPERLESS_OCR_LANGUAGE. Be sure to set this to the language the majority of your documents are in. Multiple languages can be specified, but that requires more CPU time.
  • The management command document_archiver can be used to create archived versions for already existing documents.

• Tags from consumption folder.

  • Thanks to jayme-github, paperless now consumes files from sub folders in the consumption folder and is able to assign tags based on the sub folders a document was found in. This can be configured with PAPERLESS_CONSUMER_RECURSIVE and PAPERLESS_CONSUMER_SUBDIRS_AS_TAGS.

• API

  • The API now offers token authentication.
  • The endpoint for uploading documents now supports specifying custom titles, correspondents, tags and types. This can be used by clients to override the default behavior of paperless. See the documentation on file uploads.
  • The document endpoint of API now serves documents in this form:
    • correspondents, document types and tags are referenced by their ID in the fields correspondent, document_type and tags. The *_id versions are gone. These fields are read/write.
    • paperless does not serve nested tags, correspondents or types anymore.

• Front end

  • Paperless does some basic caching of correspondents, tags and types and will only request them from the server when necessary or when entirely reloading the page.
  • Document list fetching is about 10%-30% faster now, especially when lots of tags/correspondents are present.
  • Some minor improvements to the front end, such as document count in the document list, better highlighting of the current page, and improvements to the filter behavior.

• Fixes:

  • A bug with the generation of filenames for files with unsupported types caused the exporter and document saving to crash.
  • Mail handling no longer exits entirely when encountering errors. It will skip the account/rule/message on which the error ocured.
  • Assigning correspondents from mail sender names failed for very long names. Paperless no longer assigns correspondents in these cases.

• Searching:

  • Paperless now supports searching by tags, types, dates and correspondents. In order to have this applied to your existing documents, you need to perform a document_index reindex management command (see Documentation) that adds the data to the search index. You only need to do this once, since the schema of the search index changed. Paperless keeps the index updated after that whenever something changes.
  • Paperless now has spelling corrections ("Did you mean") for miss-typed queries.
  • The documentation contains information about the search syntax.

• Front end:

  • Clickable tags, correspondents and types allow quick filtering for related documents.
  • Saved views are now editable.
  • Preview documents directly in the browser.
  • Navigation from the dashboard to saved views.

• Fixes:

  • A severe error when trying to use post consume scripts.
  • An error in the consumer that cause invalid messages of missing files to show up in the log.

• The documentation now contains information about bare metal installs and a section about how to setup the development environment.

• Setting PAPERLESS_AUTO_LOGIN_USERNAME replaces PAPERLESS_DISABLE_LOGIN. You have to specify your username.
• Added a simple sanity checker that checks your documents for missing or orphaned files, files with wrong checksums, inaccessible files, and documents with empty content.
• It is no longer possible to encrypt your documents. For the time being, paperless will continue to operate with already encrypted documents.
• Fixes:
  • Paperless now uses inotify again, since the watchdog was causing issues which I was not aware of.
  • Issue with the automatic classifier not working with only one tag.
  • A couple issues with the search index being opened to eagerly.
• Added lots of tests for various parts of the application.