26 Jul 2021
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.05.02 can be downloaded from:
Installation instructions can be found at:
Koha 21.05.02 is a bugfix/maintenance release.
It includes 1 enhancements, 51 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
[28299] OpacHiddenItems not working in OPAC lists
This fixes an issue where items that should be hidden from display in the OPAC (using the rules in OpacHiddenItems, for example: damaged) were displayed under availability in OPAC lists.
[28542] Move new authority from Z39.50/SRU to a button
This makes the layout for creating new authorities consistent with creating new records - there is now a separate button 'New from Z39.50/SRU' (rather than being part of the drop-down list).
[28455] If TrackLastPatronActivity is enabled we should update 'lastseen' field on checkouts
This updates the 'lastseen' date for a patron when items are checked out (when TrackLastPatronActivity is enabled). (The last seen date is displayed on the patron details page.)
[28242] Accessibility: OPAC - add captions and legends to tables and forms
Sponsored by Catalyst
[28422] OPAC MARC detail view doesn't correctly evaluate holdability
In the normal and ISBD detail views for a record in the OPAC the 'Place hold' link only appears if a hold can actually be placed. This change fixes the MARC detail view so that it is consistent with the normal and ISBD detail views. (Before this, a 'Place hold' link would appear for the MARC detail, even if a hold couldn't be placed, for example if an item was recorded as not for loan.)
[28545] Noisy uninitialized warn at opac-MARCdetail.pl line 313
This removes "..Use of uninitialized value in concatenation (.) or string at.." warning messages from the plack-opac-error.log when accessing the MARC view page for a record in the OPAC.
[21286] Advanced search for Corporate-name creates Zebra errors
This fixes the advanced search in the staff interface so that searching using the 'Corporate name' index now works correctly when the QueryAutoTruncate system preference is not enabled. Before this a search (using Zebra) for a name such as 'House plants' would not return any results and generate error messages in the log files.
[28601] Wrong breadcrumb for 'Home' on circulation-home
This fixes the breadcrumb link to the the staff interface home page from the circulation area - it now links correctly to the staff interface home page, rather than the circulation page.
[27498] Add a link for the hold ratios to acquisitions home page
This enhancement adds a link to the hold ratios report in the Acquisitions sidebar menu under the reports heading.
[28280] Item types configuration page doesn't use Price filter for default replacement cost and processing fee
This fixes the display of 'Default replacement cost' and a 'Processing fee (when lost)' when adding item types so that amounts use two decimals instead of six.
[28423] JavaScript error on MARC modifications page
This patch makes a minor change to the MARC modifications template (Staff interface > Administration > MARC modification templates) so that the "mmtas" variable isn't defined if there is no JSON to be assigned as its value.
The Koha manual is maintained in Sphinx. The home page for Koha documentation is
As of the date of these release notes, only the English version of the Koha manual is available:
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.05.02 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:
Release Maintainers:
We thank the following libraries who are known to have sponsored new features in Koha 21.05.02:
We thank the following individuals who contributed patches to Koha 21.05.02.
We thank the following libraries, companies, and other institutions who contributed patches to Koha 21.05.02
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-patches@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 (HEAD detached from 694665050c).
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 Jul 2021 13:33:45.