22 Dec 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.11.01 can be downloaded from:
Installation instructions can be found at:
Koha 21.11.01 is a bugfix/maintenance release.
It includes 1 enhancements, 29 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
[29620] Move the OpenAPI spec to YAML format
This enhancement moves all the Koha REST API specification from json to YAML format. It also corrects two named parameters incorrectly in camelCase to sanake_case (fundidPathParam => fund_id_pp, vendoridPathParam => vendor_id_pp).
[29631] 21.06.000.12 may fail
This fixes an issue when upgrading from 21.05.x to 21.11 - the uniq_lang unique key is failing to be created because several rows with the same subtag and type exist in database table language_subtag_registry.
[29637] AutoSwitchPatron is broken since Bug 26352
This fixes an issue introduced by bug 26352 in 21.11 that caused the AutoSwitchPatron system preference to no longer work. (When AutoSwitchPatron is enabled and a patron barcode is scanned instead of a book, it automatically redirects to the patron.)
[27801] Entering multiple lines of an item in Point of Sale can make the Collect Payment field off
This fixes the POS transactions page so that the total for the sale and the amount to collect are the same.
Before this a POS transaction with multiple items in the Sale box, say for example 9 x .10 items, the total in the Sale box appears correct, but the amount to Collect from Patron is off by a cent.
[29349] Item-level holds should assume the same pickup location as bib-level holds
Up until Koha 20.11 the pickup location when placing item-level holds was the currently logged-in library.
From Koha 21.05 the holding branch was used as the default.
This restores the previous behaviour so that the logged-in library (if a valid pickup location) is selected as the default pickup location for item-level holds. When it is not, an empty dropdown is used as a fallback.
[29586] "Hold reminder" notice doesn't show in messaging preferences in new installation
This fixes an issue with the installer files that meant "Hold reminder" notices were not shown in messaging preferences for new installations.
[28855] Purging suggestions test should not be on timestamp
This changes the date field that cronjob misc/cronjobs/purge_suggestions.pl uses to calculate the number of days for deleting accepted or rejected suggestions. It now uses the managed on date, as the last updated date that was used can be changed by other database updates.
[29487] Set autocomplete off for userid/password fields at login
This turns autocompletion off for userid and password fields on the login forms for the OPAC and staff interface.
[9565] Deleting a record should alert or fail if there are current subscriptions
This change prevents the deletion of records with current serial subscriptions.
Selecting "Delete record" when there are existing subscriptions no longer deletes the record and subscription, and adds an alert box "[Count] subscription(s) are attached to this record. You must delete all subscriptions before deleting this record.".
It also:
- adds a "Subscriptions" column in the batch deletion records tool with the number of subscriptions and a link to the search page with all the subscriptions for the record, and
- adds a button in the toolbar to enable selecting only records without subscriptions.
[28853] Textarea in biblio record editor breaks authority plugin
This fixes an issue when adding or editing record subfields using the authority plugin and it has a value with more than 100 characters. (When a subfield has more than 100 characters it changes to a text area rather than a standard input field, this caused JavaScript issues when using authority terms over 100 characters.)
[28481] Register details "Older transactions" search does not include the selected day in the "To" field in date range
This fixes the search and display of older transactions in the cash register so that items from today are included in the results. Previously, transactions for the current day were incorrectly not included.
[29115] Placing a club hold is not showing warnings when unable to place a hold
This fixes placing club holds so that checks are correctly made and warning messages displayed when patrons are debarred or have outstanding fees and charges.
[29040] Uninitialized value warning in Languages.pm
This removes the cause of the warning message "Use of uninitialized value $interface in concatenation (.) or string at /kohadevbox/koha/C4/Languages.pm line 121." when editing item types.
[29036] Accessibility: OPAC buttons don't have sufficient contrast
This improves the accessibility of the OPAC by increasing the contrast ratio for buttons, making the button text easier to read.
As part of this change the OPAC SCSS was modified so that a "base theme color" variable is defined which can be used to color button backgrounds and similar elements. It also moves some other colors into variables and removes some unused CSS.
[29556] MARC21slim2MODS.xsl broken by duplicate template name "part"
This fixes an error when making an unAPI request in the OPAC using the MODS format. A 500 page error was displayed instead of an XML file. Example URL: http://your-library-opac-domain/cgi-bin/koha/unapi?id=koha:biblionumber:1&format=MODS
[29611] Clubs enrollment layout problem in the OPAC
This fixes a minor HTML issue with the clubs enrollment form in the OPAC. The "Finish enrollment" button is now positioned correctly inside the bordered area and uses standard colors.
[29593] Wrong tag in GET /public/libraries spec
This updates the tag in GET /public/libraries (api/v1/swagger/paths/libraries.json file) from library to libraries.
[29488] NumSavedReports system preference doesn't work
This fixes the saved reports page so that the NumSavedReports system preference works as intended - the number of reports listed should default to the value in the system preference (the initial default is 20).
[29679] Reports result menu shows too many dividers
This removes borders between sections that are not required. The SQL report batch operations dropdown menu has divider list items which add a border between sections (bibliographic records, item records, etc.). This element is redundant because the sections have "headers" which also add a border.
[28216] Fix vendor list group by in serials statistics wizard
This fixes an issue where vendors are repeated in the serials report.
[29513] Accessibility: Staff Client - Convert remaining breadcrumbs sections from div to nav blocks
This improves the accessibility of breadcrumbs so that they adhere to the WAI-ARIA Authoring Practices. It covers additional breadcrumbs that weren't fixed in bug 27486 in these areas:
- Home > Acquisitions > [Vendor name > [Basket name]
- Home > Administration > Set library checkin and transfer policy
- Home > Patrons > Merge patron records
[29514] ILL requests: Remove extraneous › HTML entity from breadcrumbs
This fixes a small typo in the breadcrumbs section for ILL requests - it had an extra › HTML entity after "Home".
[29528] Breadcrumbs on HTML customizations take you to news
This change removes the "Additional contents" breadcrumb when working with news items or HTML customizations. Since news and HTML customizations are separate links on the tools home page there's no reason to have the breadcrumbs imply the two sections are connected in any way. We already have the "See News" link, for example, for switching quickly between the two areas.
[29529] Fix \n in hint on Koha to MARC mappings
This fixes:
- a string in Koha to MARC mappings (koha2marclinks.tt:86) so that it can be correctly translated (excludes "\n" from what is translated), and
- capitalization for the breadcrumb link: Administration > Koha to MARC mappings.
[29521] Patron Club name hyperlinks not operational + weird CSS behavior
This removes the link from thea patron club name on the patrons club listing page as it didn't work. It also improves the consistency of the table of patron clubs so that the interface is consistent whether you're looking at clubs during the holds process or during the clubs management view.
[29484] ListSets doesn't return noSetHierarchy when appropriate
This fixes Koha's OAI-PMH server so that it returns the appropriate error code when no sets are defined.
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.01 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 individuals who contributed patches to Koha 21.11.01
We thank the following libraries, companies, and other institutions who contributed patches to Koha 21.11.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 21.11.x.
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 22 Dec 2021 13:21:45.