26 Feb 2025
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 24.11.02 can be downloaded from:
Installation instructions can be found at:
Koha 24.11.02 is a bugfix/maintenance and security release.
It includes 5 enhancements, 61 bugfixes and 12 security fixes.
System requirements
You can learn about the system components (like OS and database) needed for running Koha on the community wiki.
37266 patron_lists/delete.pl should have CSRF protection
Sponsored by Athens County Public Libraries
38961 XSS in vendor search
Sponsored by Chetco Community Public Library
38644 Breadcrumbs disappear when zoomed in
This fixes the display of breadcrumbs in the OPAC for smaller screen sizes - when the page was zoomed in or viewed on a mobile device, the breadcrumbs disappeared.
Sponsored by Athens County Public Libraries
This fixes creating an EDIFACT order for a basket in acquisitions - if there was only one library EAN defined, then a 403 page error was generated. It also simplifies creating an EDIFACT order: - If there are no library EANs defined, the "Create EDIFACT order" button is greyed out and has a tooltip "You must define an EAN in Administration > Library EANs". - If there is only one library EAN defined, you are prompted to generate the order without needing to select an EAN. - If there is more than one library EAN, the "Create EDIFACT order" button incorporates a dropdown list with the available library EANs. (The error is related to the CSRF changes added in Koha 24.05 to improve form security.)
This fixes closing and reopening of invoices (Acquisitions > [Vendor] > Invoices). Previously, the invoices you selected weren't closed or reopened when clicking on the "Close/Reopen selected invoices" button - all that happened was that one of the selected invoices was displayed instead. (This is related to the CSRF changes added in Koha 24.05 to improve form security.)
This removes a JavaScript file previously used in OPAC templates that is no longer used (js/browserid_include.js).
This fixes a regression caused by bug 35721 in Koha 24.11. When checking in an item that needs transferring to its home library, printing the slip was generating an error ("..Active item transfer already exists' with transfer..").
This fixes the display of recalls in the holdings table - the "Recalled by [patron] on [date]" message now only shows for item-level recalls. Previously, the message was displayed for all items when a record-level recall was made.
This fixes the OCLC Connexion import daemon (misc/bin/connexion_import_daemon.pl) - the connection was failing after the CSRF token expired (after 8 hours). It now generates a new user agent when reauthenticating when the CSRF token for the session has expired. (This is related to the CSRF changes added in Koha 24.05 to improve form security.)
compare_es_to_db.pl
maintenance script require less resources when run.This fixes some missing strings in the po files used for translation. Strings in this format were being included for translation: _("This %s is picked").format(foo) However, strings using this format were not: _("This %s is NOT picked".format(bar))
This fixes the interlibrary loan (ILL) requests table so that it loads (instead of saying "Processing") when library groups are used, and: - the library group has the feature "Limit patron visibility to libraries within this group for members" (Limit patron data access by group) set - library staff don't have permission to view patron information from any libraries (view_borrower_infos_from_any_libraries).
The ILL table now loads, and shows "A patron from another library" for the patron details.
This fixes the installation process - instead of getting "Try again" when there is nothing left to do (after updating the database structure) and not being able to finish, you now get "Everything went okay. Update done."
This updates the default UNIMARC bibliographic record framework to remove the mandatory flag from some subfields and fields.
For UNIMARC, several subfields are only mandatory if the field is actually used (MARC21 does not have this requirement).
A change made to the default framework by bug 30373 in Koha 22.05 meant that if the mandatory subfield was empty, and the field itself was optional (not mandatory), you couldn't save the record.
For example, if field 410 (Series) is used (this is an optional field), then subfield $t (Title) is required. However, the way the default framework was set up (subfield $t was marked as mandatory) you couldn't save the record - as subfield $t was mandatory, even though the 410 is optional.
As Koha is not currently able to manage both the UNIMARC and MARC21 requirements without significant changes, a practical decision was made to configure the otherwise mandatory subfields as not mandatory.
Important note: This only affects NEW UNIMARC installations. Existing installations should edit their default UNIMARC framework to make these changes (although, it is likely that they have already done so).
This fixes OPAC search results when cover images are enabled - covers are now shown on all the result pages, instead of just the first page of results.
This enhancement adds cover images to OPAC lists, for OPAC enabled cover image sources.
(Note: This currently only displays nicely with one source of cover images. With multiple sources enabled, the images are listed vertically.)
38657 Image obscured by the search results toolbar when previewing cover images from OPAC search results
This fixes the display of cover images in the OPAC - the image viewer was appearing behind the search results toolbar, partially obscuring the cover image.
Sponsored by Athens County Public Libraries
This fixes the OPAC > Summary > Holds table for a logged in patron - the 'Suspend' column is now shown.
This removes unneeded Debian package dependencies. Previously we provided them in the Koha Debian repository, but we no longer need to as they are now available in the standard repositories.
This fixes the sticky header for patron search results - it now includes the column headings and filters. (This restores the behavour to what it was in Koha 23.11.)
deleted_on
This fixes SIP so that it allows noblock checkouts, regardless of normal patron checkout blocks.
Explanation: The purpose of no block checkouts in SIP is to indicate that the SIP machine has made an offline ("store and forward") transaction. The patron already has the item. As such, the item must be checked out to the patron or the library risks losing the item due to lack of tracking. As such, no block checkouts should not be blocked under any circumstances.
This fixes the item search results table in the staff interface - the "Actions" column label is now translatable.
This fixes indexing of subfields with a large amount of text (such as 500$a) - the text is now indexed, and the record can now be found. Previously, subfields with a large amount of text were not correctly indexed.
This fixes a regression from the Boostrap 5 upgrade for print notices. Each notice is now on its own page, instead of running one after the other without a page break (when running gather_print_notices.pl with HTML file output). (This is related to the OPAC and staff interface Bootstrap 5 upgrade in Koha 24.11.)
This fixes the display of the plugins page, when plugins are disabled in koha-conf.xml and the page is accessed directly. The message that plugins are disabled is now indented, instead of aligned to the far left.
38268 Callers of confirmModal need to remove the modal as the first step in their callback function
This fixes confirm dialog boxes in the OPAC to prevent unintended actions being taken, such as accidentally deleting a list. This specifically fixes lists, and makes a technical change to prevent this happening in the future for other areas of the OPAC (such as suggestions, tags, and self-checkout).
Example of issue fixed for lists:
- Create a list with several items.
- From the new list, select a couple of the items.
- Click "Delete list" and then select "No, do not delete".
- Then select "Remove from list", and confirm by clicking "Yes, remove from list".
- Result: Instead of removing the items selected, the whole list was incorrectly deleted!
Sponsored by Chetco Community Public Library
37634 Missing "USE Koha" causes JS errors and missing "Last patron" menu
This fixes the cause of the "Last patron" menu not displaying on many staff interface pages, or generating JavaScript errors (where showLastPatron is enabled). (It adds "[% USE Koha %]" to templates where it was missing. It also removes some duplicate USE entries.)
Sponsored by Athens County Public Libraries
38347 Fix style of sidebar form submit button on bookings to collect page
This fixes the style for the submit button on the bookings to collect page (Circulation > Bookings to collect). It now has the same yellow "primary" style as other submit buttons, and it fills the width of the sidebar.
Sponsored by Athens County Public Libraries
38350 Fix style of sidebar form clear buttons
This fixes the markup and CSS for sidebar forms that contain a submit button and a clear button (for example, the patrons and ILL requests sidebars). The submit button is now wider than the clear button for visual emphasis.
Sponsored by Athens County Public Libraries
38519 Improve contrast of Bootstrap alerts and text background classes
This updates the staff interface CSS to improve the visibility and contrast in Bootstrap alerts and text with background classes. (This is related to the OPAC and staff interface Bootstrap 5 upgrade in Koha 24.11.)
Sponsored by Athens County Public Libraries
This fixes the HTML customization display location dropdown list so that the "Staff" grouping is now "Staff interface". This makes it clearer for translation.
38701 Fix HTML validity errors in invoice template
This fixes some HTML markup errors on the Acquisitions > Invoices page - it now passes W3C HTML validation checks.
Sponsored by Athens County Public Libraries
31450 HTML customizations and news will not display on OPAC without a publication date
This fixes the display of news, HTML customizations, and pages on the OPAC - a publication date is now required for all types of additional content. Previously, news items and HTML customizations were not shown if they didn't have a publication date (this behavour was not obvious from the forms).
Sponsored by Athens County Public Libraries
This fixes the inventory tool so that it ignores case sensitivity for barcodes, similar to other areas of Koha such as checking in and checking out items (for example, ABC123 and abc123 are treated the same).
This improves searching for patron clubs on a record's holds page - it now works similar to the patron search tab. You can now click search with no text in the search box, and a list of clubs are displayed. Previously, you had to enter the club ID or partial name to get a result.
This enhancement adds CSS classes to each of the main sections on the reports home page: - Reports dictionary: rep_dictionary * - Statistics wizards: rep_wizards - Report plugins: rep_plugins - Top lists: rep_top - Inactive: rep_inactive - Other: rep_other
- This change also corrects the heading level for reports dictionary to an H2 (from an H5), to correctly reflect the page structure.
System Administration
37311 Tone down the SMTP servers administration page
This enhancement improves the SMTP servers administration page.
It reformats the information section at the top of the page with the current default SMTP server detailsand adds an edit link.
For the table listing all the SMTP servers:
- "Is default" column: if the server is the default, it is highlighted with a green badge and "Default" in bold (the row is no longer in red and italicised, implying action is required to fix something).
- "Debug mode" column: if the server is in debug mode, it is highlighted with a yellow badge and "On" in bold.
Sponsored by Athens County Public Libraries
This enhancement to the batch patron modification tool allows superlibrarians to batch update the protected status setting for patrons, instead of having to change each patron individually. The edit patrons form now includes the "Protected" field. (The protected status option for patrons was added in Koha 23.11.
The Koha manual is maintained in Sphinx. The home page for Koha documentation is
Koha Documentation As of the date of these release notes, the Koha manual is available in the following languages:
Armenian (hy_ARMN) (58%)
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 24.11.02 is
Release Manager: Katrin Fischer
Release Manager assistants:
QA Manager: Martin Renvoize
QA Team:
Security Manager: Tomás Cohen Arazi
Topic Experts:
Bug Wranglers:
Packaging Manager: Mason James
Documentation Manager: Philip Orr
Documentation Team:
Wiki curators:
Release Maintainers:
We thank the following libraries, companies, and other institutions who are known to have sponsored new features in Koha 24.11.02
We thank the following individuals who contributed patches to Koha 24.11.02
We thank the following libraries, companies, and other institutions who contributed patches to Koha 24.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 main branch of:
The branch for this version of Koha and future bugfixes in this release line is 24.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 26 Feb 2025 18:36:49.