03 Oct 2022
Koha is the first free and open source software library automation package (ILS). Development is sponsored by libraries of varying types and sizes, volunteers, and support companies from around the world. The website for the Koha project is:
Koha 21.11.12 can be downloaded from:
Installation instructions can be found at:
Koha 21.11.12 is a bugfix/maintenance release.
It includes 10 enhancements, 37 bugfixes.
You can learn about the system components (like OS and database) needed for running Koha here: https://wiki.koha-community.org/wiki/System_requirements_and_recommendations
[31121] Format date range on top of cashup summary page
This fixes the formatting of dates on the cashup summary modal (it uses the existing $datetime JS include).
[29114] Can not add barcodes with whitespaces at the beginning to the list
This fixes an issue where barcodes with white spaces at the beginning could not be added to a list.
[26689] Monetary accounts notices should be definable at the credit_type/debit_type level
This enhancement allows end users to define their account notices (print receipt and print invoice for example) at the debit type and credit type level.
Simply add a new notice with code 'DEBIT_your_debit_type_code' or 'CREDIT_your_credit_type_code' to the notices and we will pick that over the existing default 'ACCOUNT_DEBIT' and 'ACCOUNT_CREDIT' notices.
[29922] Group of libraries are now displayed in alphabetical order
This fixes the display of library groups in the advanced search (Groups of libraries) for the OPAC and staff interface so that they correctly sort in alphabetical order. Before this:
- OPAC: were sorted in the order library groups were added, group names with diacritics and umlauts (such as Ä or À) came last (after something starting with Z)
- Staff interface: were sorted correctly, but had the same issue as the OPAC for group names with diacritics and umlauts
[31213] When performing a basic search with no results, repeat the search with term quoted
This enhancement adds a second, automatic, search with the search terms between quotation marks when a search returns no results.
For example, searches with special characters don't work with Elasticsearch. A search for Ivy + Bean will return no results. But a search for "Ivy + Bean" will return results.
With this enhancement, if a user searches for Ivy + Bean without quotation marks and gets no results, Koha will automatically search for "Ivy + Bean" and return those results.
This targets both Zebra and Elasticsearch, but is more relevant for Elasticsearch.
[27667] Display the number of non-indexed records
This enhancement adds information about non-indexed records when using the Elasticsearch search engine on the About Koha > System information page.
For example:
Records are not indexed in Elasticsearch
- Warning 1 record(s) missing on a total of 435 in index koha_kohadev_biblios.record(s).
- Warning 1 record(s) missing on a total of 1705 in index koha_kohadev_authorities.
[31036] Cash management doesn't take SIP00 (Cash via SIP2) transactions into account
This fix adds the last missing piece for cash management when involving transactions via a SIP client.
We now understand that a SIP00 coded transaction is equal to 'CASH' in other register environments. This means we treat it as such in the cashup system and also that we now require a register for cash transactions.
WARNING: This makes register a required configuration field for SIP devices when cash registers are enabled on the system.
[21982] Circulation statistics wizard does not count deleted items
This patch corrects a bug in the Circulation statistics wizard. Previously, the wizard only looked at existing items to calculate statistics. It now includes transactions made on items that are now deleted.
[30882] Add max_result_window to index config
This updates the number of results set by default in Elasticsearch for the setting "index.max-result-window" from 10,000 to 1,000,000. This can be useful for really large catalogs.
[31039] Rebase issues lead to duplicate JS for cash summary modal printing
This fixes a duplicate print dialogue box appearing when printing the cashup summary for cash registers - ins some circumstances when cancelling the print dialogue, it reappeared instead of closing.
[31020] PassItemMarcToXSLT only applies on results pages
This fixes the note about the PassItemMarcToXSLT system preference so that it is only shown for the OPACXSLTResultsDisplay and XSLTResultsDisplay system preferences - it was appearing in all XSLT system preferences, when it only applies for results pages. (The note is removed from OPACXSLTListsDisplay, XSLTListsDisplay, OPACXSLTDetailsDisplay, and XSLTDetailsDisplay system preferences.)
The Koha manual is maintained in Sphinx. The home page for Koha documentation is
As of the date of these release notes, the Koha manual is available in the following languages:
The Git repository for the Koha manual can be found at
Complete or near-complete translations of the OPAC and staff interface are available in this release for the following languages:
Partial translations are available for various other languages.
The Koha team welcomes additional translations; please see
For information about translating Koha, and join the koha-translate list to volunteer:
The most up-to-date translations can be found at:
The release team for Koha 21.11.12 is
Release Manager: Jonathan Druart
Release Manager assistants:
QA Manager: Katrin Fischer
QA Team:
Topic Experts:
Bug Wranglers:
Packaging Manager:
Documentation Manager: David Nind
Documentation Team:
Translation Managers:
Wiki curators:
Release Maintainers:
Release Maintainer assistants:
Release Maintainer mentors:
We thank the following individuals who contributed patches to Koha 21.11.12
We thank the following libraries, companies, and other institutions who contributed patches to Koha 21.11.12
We also especially thank the following individuals who tested patches for Koha
We regret any omissions. If a contributor has been inadvertently missed, please send a patch against these release notes to koha-devel@lists.koha-community.org.
The Koha project uses Git for version control. The current development version of Koha can be retrieved by checking out the master branch of:
The branch for this version of Koha and future bugfixes in this release line is 21.11.x.
Bug reports and feature requests can be filed at the Koha bug tracker at:
He rau ringa e oti ai. (Many hands finish the work)
Autogenerated release notes updated last on 03 Oct 2022 21:04:59.