25 Jul 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.03 can be downloaded from:
Installation instructions can be found at:
Koha 22.05.03 is a bugfix/maintenance release with security fixes.
It includes 1 security fixes, 8 enhancements, 32 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
[30997] "CGI::param called in list context" warning in detail.pl flooding error log
This fixes the cause of "CGI::param called in list context from" warning messages that appear in the log files when viewing record detail pages in the staff interface.
[30923] OAuth2 implementation is not experimental
This enhancement removes the [EXPERIMENTAL] text from the RESTOAuth2ClientCredentials system preference description. OAuth2 has been in use by third parties to securely interact with Koha since its introduction in 2018.
[27519] Normalize Show/Don't show vs Display/Don't display in system preferences
This enhancement replaces "Display/Don't display" with "Show/Don't show" for several system preferences to improve terminology consistency and make translation easier. A few preferences were also updated where "Yes/No" and "Show/Hide" were used.
[30806] Use patron-title.inc in member-flags template
This enhancement updates the template for the patron set permissions page (members/member-flags.pl) to use the patron-title.inc include wherever patron names are referenced. This is used to format patron name names consistently, rather than a custom format each time the patron name is referenced. The patron name is now displayed as "Set permissions for firstname lastname (patron card number), instead of "Set permissions for lastname, firstname".
[30807] Use patron-title.inc in patron payments pages
This enhancement updates the templates for patron accounting - make a payment tab and payment pages (pay and write off options) to use the patron-title.inc include wherever patron names are referenced. This is used to format patron name names consistently, rather than a custom format each time the patron name is referenced. The patron name is now displayed as "Make a payment for firstname lastname (patron card number)" and "Pay charges for firstname lastname (patron card number)".
[30539] Koha upgrade error "Column 'claimed_on' cannot be null"
This fixes an upgrade error that could result in data loss when upgrading from earlier releases to 20.05 (and later releases). It results in the claim_dates for orders being replaced with the date the upgrade was run. (This was caused by an error in the database update for bug 24161 - Add ability to track the claim dates of later orders.)
[29607] addorderiso2709: The stored discount when importing an order from a file is invalid
This fixes how the discount amount for an order is stored and shown when an order is added to a basket using "From staged MARC records". The discount amount was incorrectly stored in the database and shown incorrectly when modifying the order (for example, a 25% discount shown as 0.2500 in the database and .25% on the form). This would result in the order amount changing when modifying an order.
[30938] Fix column configuration to the acquisitions home page
This fixes the acquisitions home page to show the column configuration button.
[30958] OPAC Overdrive search result page broken for translations
Sponsored by Melbourne Athenaeum Library, Australia
[29260] UNIMARC 210a is reported to Author (meeting/conference) when upgrading an authority through Z3950
This fixes UNIMARC authority editing when using 'Replace record via Z3950/SRU search'. When pre-populating the search form the value of 210$a (Authorized Access Point - Corporate Body Name) now goes into the Author (corporate) search form field instead of Author (meeting / conference).
[28355] Add warning note about Email SMS driver option for SMSSendDriver
This updates the text for the SMSSendDriver system preference. The Email SMS driver option is no longer recommended unless you use a dedicated SMS to Email gateway. Many mobile providers offer inconsistent support for the email to SMS gateway (sometimes it works, and sometimes it doesn't), which can cause frustration for patrons.
[30989] Tags with some special characters are not encoded right
This fixes tags with special characters (such as +) so that the searching returns results when the tag is selected (from the record detail view in the OPAC and staff interface, and from the search results, tag cloud, and list pages in the OPAC).
[30713] Patron entry should limit date of birth selection to dates in the past
This fixes the date of birth field for the patron entry form so that the calendar widget does not let you select a date in the future.
[30780] Librarians with only "place_holds" permissions can not update holds data via REST API
Sponsored by Koha-Suomi Oy
This enhancement enables librarians with only "place_holds" permissions to cancel, suspend and resume holds using the REST API.
[30798] Columns Home library and Checked out from in wrong order on table settings for account_fines table
Sponsored by Koha-Suomi Oy
[30864] Patron category form - no validation for password expiration field
This adds validation to the "Password expiration" field on the patron category form. If letters or other characters were entered, there was no error message. If what was entered was not a number, then it was not saved.
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.03 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.03
We thank the following individuals who contributed patches to Koha 22.05.03
We thank the following libraries, companies, and other institutions who contributed patches to Koha 22.05.03
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 25 Jul 2022 16:00:59.