31 Jan 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.02 can be downloaded from:
Installation instructions can be found at:
Koha 21.11.02 is a bugfix/maintenance release with security fixes.
It includes 9 security fixes, 3 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
[29741] Add Koha::Patron->safe_to_delete
This enhancement adds a handy method for checking if a patron meets the conditions to be deleted. These conditions are:
- Has no linked guarantees
- Has no pending debts
- Has no current checkouts
- Is not the system-configured anonymous user
It also adapts the DELETE /patrons route to use the newly introduced Koha::Patron->safe_to_delete method.
[26587] Cache libraries in Branches TT plugin to improve performance
Sponsored by Lund University Library
[20076] Overdues email to library for patrons without email should be optional
Currently, two print notices are generated when running overdue_notices.pl if a patron does not have an email address:
- a print overdue notice for the patron, and
- an email message to the library with all the print versions of the overdue notices.
Depending on a library's work processes, they may want both or only the patron print overdue notice generated.
This enhancement adds a new system preference, EmailOverduesNoEmail, that allows libraries to choose whether to send or not send overdue notices for patrons without an email address to library staff. The default is set to send, as this preserves the current behaviour.
[29670] Restore functionality broken by bug 27708 for AcqCreateItem set to "placing an order"
This patch restores the lost GIR segments in EDI messages generated by orders with items attached.
[29457] Fee Cancellation records the wrong manager_id
Prior to this patch inadvertently the field borrowers.userid was used to fill accountslines.manager_id. This should have been borrowernumber.
This report fixes that and prints a generic warning.
[29018] Deleting patrons from REST API doesn't do any checks or move to deletedborrowers
These fixes the REST API route for deleting patrons so that it now checks for guarantees, debts, and current checkouts. If any of these checks fail, the patron is not deleted.
[24866] Display budget hierarchy in the budget dropdown menu used when placing a new order
This improves the display for selecting a fund when placing a new order in acquisitions. It now displays as a hierarchy instead of a list without any indentation, for example:
Budget 2021 -- Book -- -- Adult fiction
[29588] Yesterday and tomorrow in datepicker don't translate
This fixes "or", "Yesterday", "Today" and "Tomorrow" in the flatpickr date selector so they can be translated. (This was because _ was used when _ should have been used (_ is for .js files only)).
[29557] Auto renew notices should handle failed renewal due to patron expiration
This enhancement updates the default auto-renewal notices to tell patrons that their renewals have failed because their account has expired.
[17127] Can't hide MARC21 500 and others with NotesToHide
This fixes hiding notes fields (5XX in MARC21 and 3XX in UNIMARC) using NotesToHide. Before this you could hide one field and it worked. However, when hiding multiple fields one field would still always be visible. Now hiding notes fields works as expected.
[29530] When NumSavedReports is set, show value in pull down of entries
This updates the way the NumSavedReports preference value is used on the saved reports page. For the "Show" dropwdown list:
- it now displays the number set in NumSavedReports (previously it showed 20)
- when expanded it now shows the number set in NumSavedReports sequentially (for example, if NumSavedReports is 78, the menu options should be "10, 20, 50, 78, 100, All"), and
- it now displays 'All' if NumSavedReports is blank.
It also updates the description for the NumSavedReports preference to clarify that all reports are shown when no value is entered.
[29571] Mainpage : "All libraries" pending suggestions are visible only if the current library has suggestions
This fixes the display of pending suggestions in the staff interface so that it now shows pending suggestions for all libraries, for example: "Suggestions pending approval: Centerville: 0 / All libraries: 1.". Previously suggestions pending approval was only shown if there were suggestions for the user's current library.
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 21.11.02 is
Release Manager: Fridolin Somers
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 21.11.02
We thank the following individuals who contributed patches to Koha 21.11.02
We thank the following libraries, companies, and other institutions who contributed patches to Koha 21.11.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-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 v21.11.02.
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 31 Jan 2022 18:14:01.