RELEASE NOTES FOR KOHA 25.05.06

04 Dec 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 Community

Koha 25.05.06 can be downloaded from:

• Download

Installation instructions can be found at:

• Koha Wiki
• OR in the INSTALL files that come in the tarball

Koha 25.05.06 is a bugfix/maintenance release.

It includes 58 bugfixes, 2 of them are security fixes.

System requirements

You can learn about the system components (like OS and database) needed for running Koha on the community wiki.

Security bugs

• 35830 Add separate permission for Merging Patrons

  Sponsored by Cape Libraries Automated Materials Sharing

• 40524 Stored XSS run by DataTables Print button in staff interface

Bugfixes

Accessibility

Other bugs fixed

• 41198 Add visible “Sort results by” label above the sort dropdown for accessibility and clarity

  Adds a visible “Sort results by” label above the sort dropdown in OPAC search results to improve accessibility and clarity.

• 41201 Definite article in some labels confuses screen readers

Acquisitions

Other bugs fixed

• 38516 Closed group basket not able to open pdf file with adobe The root object is missing or invalid
• 40988 Subfunds in acqui-home.pl and aqbudgets.pl are not collapsible beyond 20th line
• 41100 EDI vendor account port numbers no longer editable

  This fixes editing EDI account port numbers in Koha 25.05.x. When editing the port numbers for an account (Administration > Acquisition parameters > EDI accounts), the changes were not saved.

Architecture, internals, and plumbing

Other bugs fixed

• 40559 Fix a noisy warn in catalogue/MARCdetail
• 41024 Inconsistent spelling of Borrower(s)Log
• 41032 Open Fifth missing in plugin repos config

  This updates the template used when creating Koha instances - it changes the plugin repository details for Open Fifth (previously PTFS-Europe), so that you can search and install plugins using the staff interface.

  To update existing Koha instances (where uploading and installing plugins from Git repositories is enabled) change the PTFS-Europe details to Open Fifth in the /etc/koha/sites//koha-conf.xml:

  Open Fifth openfifth github

• 41044 Fix argument isn't numeric in addition in Koha::Item::find_booking
• 41104 Samesite HTTP response header being set in C4::Auth::checkauth()
• 41123 Remove useless dbh statement from Patron
• 41262 Duplicate import in Koha::Patron

Authentication

Other bugs fixed

• 41038 Add more test coverage for bug 30724

Cataloging

Other bugs fixed

• 41205 Error in Advanced Cataloging editor when z39 source returns undef / empty records

Circulation

Critical bugs fixed

• 40205 "Default checkout, hold and return policy" cannot be unset
• 41314 Column visibility broken on the checkouts table

  This fixes the display of the 'Export' column on a patron's check out and details sections when ExportCircHistory is enabled and disabled. Because of a regression (caused by DataTable's saveState, bug 33484), the column was not correctly shown unless you cleared the cache/local storage: - If ExportCircHistory was set to 'Show', it is shown the first time. - If ExportCircHistory is then set to 'Don't show', the export column continues to show until you clear the browser cache/local storage.

Other bugs fixed

• 24533 Improved sorting in checkouts table
• 41149 Spinner/loader does not disappear when a renewal fails with AllowRenewalOnHoldOverride set to dont allow
• 41298 Filtering holdings table with status In transit considers every item ever transferred to be "In transit"

Command-line Utilities

Other bugs fixed

• 39532 Script debar_patrons_with_fines.pl should not use MANUAL restriction type
• 41008 bulkmarcimport.pl -d broken for authorities

ERM

Critical bugs fixed

• 38446 Permission error for additional fields

  Sponsored by Karlsruhe Institute of Technology (KIT)

ILL

Other bugs fixed

• 41257 ILL "List requests"/"Refresh" wording doesn't work

Installation and upgrade (command-line installer)

Critical bugs fixed

• 41167 Rewrite Rules missing in etc/koha-httpd.conf

Notices

Other bugs fixed

• 39985 items.onloan field is not updated when an item is recalled

  Sponsored by Auckland University of Technology

OPAC

Other bugs fixed

• 30633 Move OPACHoldingsDefaultSortField to table settings configuration

  Restore the ability to define a default sort order for the holdings table at the OPAC. It replaces the system preference "OPACHoldingsDefaultSortField" that had been broken for a while. Note that its value is not migrated.

• 38080 Sorting options for holdings table are incorrect This fixes the default sort order for the OPAC holdings table, so that the default table sorting setting is used. Previously, it was not correctly using this setting (for example, setting the shelving location as the default sort order did not work).
• 40836 Credit and debit types are not shown in patron account on OPAC
• 40873 AV dropdowns in OPAC don't use lib_opac values This fixes the value displayed in dropdown lists for authorized values in the OPAC. The value entered in the 'Description (OPAC)' field is now shown for authorized value dropdown lists. Previously, the value shown was what was in the 'Description' field.

  Example: for the SUGGEST_FORMAT authorized value category, the value in 'Description (OPAC)' is now shown in the dropdown list for the item type field on the purchase suggestion form in the OPAC.

• 40903 OPAC advanced search applies a location limit of the logged-in library by default
• 41078 Improve handling of multiple covers on shelves/lists results in the OPAC
• 41168 "Search the catalog by keyword" confuses some users This updates the main OPAC search field hint text from "Search the catalog by keyword" to "Search the catalog". This avoids any confusion about only being able to search by keyword.
• 41177 Breadcrumbs should have aria-disabled attribute if its the current page

Patrons

Critical bugs fixed

• 41094 search_anonymize_candidates returns too many candidates when FailedLoginAttempts is empty

Other bugs fixed

• 29908 Warning when empty ClaimReturnedWarningThreshold in patron_messages.inc
• 41039 Patron search button can be spammed and trigger many API patron searches
• 41053 Make notice contents searchable on notices tab of patron details
• 41067 'OPAC mandatory' attribute setting requires 'Editable in OPAC' to work
• 41212 members/maninvoice.pl debit_types should sort by description not code

Plugin architecture

Other bugs fixed

• 25952 Github search errors make it impossible to install plugins from other repos

  This fixes the error 500 "malformed JSON string" message when something goes wrong searching for plugins using the plugin search in the staff interface (for example, when there is an invalid repository in the Koha configuration).

• 40983 Remove deprecated syntax for 'after_biblio_action' hooks IMPORTANT: The former biblio and biblio_id params of after_biblio_action hooks/plugins have been removed now. They were deprecated on bug 36343 and replaced by the payload hash. Please adjust your plugins using them, if you did not do so already.

Point of Sale

Other bugs fixed

• 40625 Prevent cashup re-submissions on page reload

REST API

Critical bugs fixed

• 39336 Public Biblio endpoint should honour OpacSuppression syspref

Reports

Other bugs fixed

• 40961 LocalUse Circulation Statistics offering empty results
• 41082 Renaming columns in reports doesn't work with batch tools
• 41112 Space is missing in report preview

  This fixes the 'Delete' button when previewing the SQL for a saved report - there is now a space between the trash can icon and Delete.

Staff interface

Critical bugs fixed

• 38072 Regression with modalPrint

  This fixes a regression when printing dialogue boxes in certain Chromium-based browsers, for example, when printing the cashup summary for the point of sale system. Sometimes the print dialog failed to open, and instead you were faced with a flash of white before the new tab automatically closed and didn't print.

• 41229 Cash registers are not fully reset on library change

System Administration

Other bugs fixed

• 41092 Some system preferences have target='blank' instead of target='blank'

  This fixes the HTML target attribute for some system preference links that open a pop-up window or external link. The link attribute now uses "blank" instead of "blank", and opens in a new tab for external links, and the same browser window for pop-up windows (modals).

Templates

Other bugs fixed

• 40664 Serial subscription input missing "Required" labels

  This fixes the second page of the new serial subscription form - it adds missing "Required" labels next to two mandatory fields ('Frequency' and 'Subscription start date').

• 40720 Misleading title attribute "Remove all items" in Select2 fields

  Improvement: Updated Select2 title text for clarity

  This patch updates the Select2 initialization script to improve accessibility and clarity. The title attribute on the “X” control (used to clear selections in Select2 dropdowns) now reads “Clear selections” instead of “Clear items,” eliminating ambiguity.

  Sponsored by Athens County Public Libraries

• 40760 'Edit' link in item receive table is not formatted as link

• 41207 Permission description string does match permission name

  Sponsored by Cape Libraries Automated Materials Sharing

Test Suite

Other bugs fixed

• 38475 InfiniteScrollSelect_spec.ts is failing randomly again
• 40845 t/Koha/Manual.t only passes for 25.05 and 25.06

Tools

Other bugs fixed

• 40843 On modborrowers.pl patron attributes should sort by the description, not the code

  This patch fixes a problem in the batch patron modification tool where extended patron attributes were sorting based on the code, instead of the description.

Deleted system preferences

• OPACHoldingsDefaultSortField

Documentation

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:

• English (USA)

• French (75%)
• German (94%)
• Greek (98%)
• Hindi (67%)

The Git repository for the Koha manual can be found at

• Koha Git Repository

Translations

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

• Koha Translation Info

For information about translating Koha, and join the koha-translate list to volunteer:

• Koha Translate List

The most up-to-date translations can be found at:

• Koha Translation

Release Team

The release team for Koha 25.05.06 is

• Release Manager: Lucas Gass

• QA Manager: Martin Renvoize

• QA Team:

  • Andrew Fuerste-Henry
  • Andrii Nugged
  • Baptiste Wojtkowski
  • Brendan Lawlor
  • David Cook
  • Emily Lamancusa
  • Jonathan Druart
  • Julian Maurice
  • Kyle Hall
  • Laura Escamilla
  • Lisette Scheer
  • Marcel de Rooy
  • Nick Clemens
  • Paul Derscheid
  • Petro V
  • Tomás Cohen Arazi
  • Victor Grousset

• Documentation Manager: David Nind

• Documentation Team:

  • Aude Charillon
  • Caroline Cyr La Rose
  • Donna Bachowski
  • Heather Hernandez
  • Kristi Krueger
  • Philip Orr

• Translation Manager: Jonathan Druart

• Wiki curators:

  • George Williams
  • Thomas Dukleth

• Release Maintainers:

  • 25.05 -- Paul Derscheid
  • 24.11 -- Fridolin Somers
  • 24.05 -- Jesse Maseto
  • 22.11 -- Catalyst IT (Wainui, Alex, Aleisha)

• Release Maintainer assistants:

  • 25.05 -- Martin Renvoize
  • 24.11 -- Baptiste Wojtkowski
  • 24.05 -- Laura Escamilla

Credits

We thank the following libraries, companies, and other institutions who are known to have sponsored new features in Koha 25.05.06

We thank the following individuals who contributed patches to Koha 25.05.06

We thank the following libraries, companies, and other institutions who contributed patches to Koha 25.05.06

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.

Revision control notes

The Koha project uses Git for version control. The current development version of Koha can be retrieved by checking out the main branch of:

• Koha Git Repository

The branch for this version of Koha and future bugfixes in this release line is 25.05.x.

Bugs and feature requests

Bug reports and feature requests can be filed at the Koha bug tracker at:

• Koha Bugzilla

He rau ringa e oti ai. (Many hands finish the work)

Autogenerated release notes updated last on 04 Dec 2025 09:22:01.