27 Jun 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.01 can be downloaded from:
Installation instructions can be found at:
Koha 22.05.01 is a bugfix/maintenance release.
It includes 5 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
[30733] Simplify translatable strings
Cleanup of translatable text done by guiding the string extractor to make it do simpler strings for translators instead of large concatenation of long strings in the code with a lot of unnecessary %s placeholders.
[30786] Capitalization in (Opac)AdvancedSearchTypes
This fixes the descriptions for the AdvancedSearchTypes and OpacAdvancedSearchTypes system preferences - sentence case is now used for "..Shelving location..".
[30234] Serial local covers don't appear in the staff interface for other libraries with SeparateHoldings
This fixes the display of item-specific local cover images in the staff interface. Before this, item images were not shown for holdings on the record's details view page.
[30885] Recall - detail page explosion
Sponsored by Catalyst
[30886] Recall status cannot be correct on OPAC detail page
Sponsored by Catalyst
[30971] Recalls - log viewer error
This fixes an error that occurred when viewing recalls log entries. The error was caused by the renaming of itemnumber, biblionumber, and branchcode attributes.
[29325] commit_file.pl error 'Already in a transaction'
This fixes the command line script misc/commit_file.pl and manage staged MARC records tool in the staff interface so that imported records are processed.
The error message from The command line script was failing with this error message "DBIx::Class::Storage::DBI::exectxn_begin(): DBI Exception: DBD::mysql::db begin_work failed: Already in a transaction at /kohadevbox/koha/C4/Biblio.pm line 303". In the staff interface, the processing of staged records would fail without any error messages.
[30899] Upgrade sometimes fails at "Upgrade to 21.11.05.004"
This database revision fixes the one from bug 30449 for table borrower_attribute_types.
[30868] Modifying a patron - page not found error after fixing validation errors where the message is displayed at the top of the page
This fixes a page not found error message generated after fixing validation errors when editing a patron (where the validation/error message is shown at the top of the page - below the patron name, but before the Save and Cancel buttons). (This was introduced by bug 29684: Fix warn about js/locale_data.js in 22.05.)
[31005] Cannot edit patrons in other categories if an extended attribute is mandatory and limited to a category
This fixes an error when a mandatory patron attribute limited to a specific patron category was causing a '500 error' when editing a patron not in that category.
[30883] Authorities merge is limited to 100 biblio with Elasticsearch
This fixes the hard-coded limit of 100 when merging authorities (when Elasticsearch is the search engine). When merging authorities where the term is used over 100 times, only the first 100 authorities would be merged and the old term deleted, irrespective of the value set in the AuthorityMergeLimit system preference.
[30842] Two-factor authentication code should be valid longer
This extends the time a two-factor authentication code is valid for, in case it is not entered quickly enough. (Example: wait for the code to change, then enter the previous code - this should still work, but will not work when the code changes again.)
[30893] Typo: update_patrons_category.pl fine(s)
This updates the help text for the update patrons category cronjob script (misc/cronjobs/update_patrons_category.pl). It changes the full option names and associated information for -fo (--fineover to --finesover) and -fu (--fineunder to --finesunder), as well as some minor formatting and text tidy ups.
[23659] Allow hold pickup location to default to item home branch for item-level holds
This patch adds a new system preference 'DefaultHoldPickupLocation'
This preference will allow the library to determine which library is the default for pickup location dropdowns while placing holds in the staff client. The options are logged in library, homebranch, or holdingbranch
Previously the behavior was inconsistent, and varied between versions. Libraries may need to adjust this preference after upgrade to mirror their expected workflow
[30844] The OPAC detail page's browser is limited to the current page of results when using Elasticsearch
Sponsored by Lund University Library
[30629] in title of patron card creator template needs to be removed
This removes tags incorrectly displaying in browser page titles for some pages in the staff interface (Tools > Patron card creator > Layouts; Tools > Label creator > Manage > Label batches; Administration > Budgets administration > select a budget > Plan by ...).
The Koha manual is maintained in Sphinx. The home page for Koha documentation is
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.01 is
We thank the following libraries, companies, and other institutions who are known to have sponsored new features in Koha 22.05.01
We thank the following individuals who contributed patches to Koha 22.05.01
We thank the following libraries, companies, and other institutions who contributed patches to Koha 22.05.01
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 27 Jun 2022 15:28:28.