26 Sep 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 22.05.05 can be downloaded from:
Installation instructions can be found at:
Koha 22.05.05 is a bugfix/maintenance release.
It includes 15 enhancements, 48 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
[30905] Show waiting recalls in patron account on checkouts tab
Sponsored by Catalyst
This enhancement shows recalls ready for pick-up on the patron's account so they can't be missed.
[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).
[31068] Context for translation: Print (verb) vs. Print (noun)
This enhancement adds context for translation purposes to the term 'Print' for notices and slips message transport types (email, print, SMS). (In English, the word "print" is the same whether it is a verb (to print something) or a noun (a print of something), however, for other languages different words may be used. When the word is in a sentence, it's not too difficult to translate, but in cases where the string to translate is simply "Print", it is often used in different cases (noun or verb). For example: in French there are two different spellings, "Imprimer" or "Imprimé".)
[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.
[31069] Did you mean? in the OPAC - links have tags
This removes tags incorrectly displayed around the links for options available when 'Did you mean?' is enabled (for example, 'Search also for related subjects').
[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.
[29094] Placing holds via SIP2 does not check if a patron can hold the given item
This fixes holds placed using SIP2 to check that the patron can actually place a hold for the item.
[15187] Adding 880 Fields to index-list in order to Increase Search for ALL non-latin Scripts
This fixes the Zebra search engine when using ICU* so that 880 fields are rewritten as their linked fields and the alternate graphic representation of fields are indexed, in the same way that it works for Elasticsearch.
Example: add 245-01 to 880$6 and 教牧書信 to 880$a - the Chinese characters are now indexed into the title index using the 245 rules.
- ICU is a feature of the Zebra search engine that can be configured to make searching with non-latin languages (such as Chinese and Arabic) work correctly.
[29632] Callnumber sorting is incorrect in Elasticsearch
This fixes the sorting of call numbers when using Elasticsearch. Sorting will now work correctly for non-numeric call numbers, for example, E45 will now sort before E7.
[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 22.05.05 is
Release Manager: Tomás Cohen Arazi
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:
We thank the following libraries, companies, and other institutions who are known to have sponsored new features in Koha 22.05.05
We thank the following individuals who contributed patches to Koha 22.05.05
We thank the following libraries, companies, and other institutions who contributed patches to Koha 22.05.05
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 rmain2205.
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 26 Sep 2022 14:32:01.