RELEASE NOTES FOR KOHA 25.05.02

24 Jul 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.02 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.02 is a bugfix/maintenance release.

It includes 25 enhancements, 96 bugfixes.

System requirements

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

Security bugs

• 40030 HTML should be escaped when viewing system preferences diff in Log viewer

Bugfixes

About

Critical bugs fixed

• 40370 about.pl should NOT say “Run the following SQL to fix the database”

Other bugs fixed

• 40022 Release team 25.11

Accessibility

Other bugs fixed

• 40165 Incomplete logic for controlling display of OPAC language footer

  Sponsored by Athens County Public Libraries

Acquisitions

Other bugs fixed

• 39572 Create EDIFACT order button no longer forces librarians to review EAN to select

  This fixes the EDIFACT order confirmation message for a basket so that the EAN information is now included on the confirmation page ([a basket for a vendor] > Create EDIFACT order > [select EAN from dropdown list], with the BasketConfirmations system preference set to ‘always ask for conformation’).

  Previously, the Create EDIFACT order action would take librarians to a page to select the EDI Library EAN. Now, the EANs are included in a dropdown list for the action. This removed the chance to review the selected EAN to confirm it was correct. In addition, some libraries have dozens of Library EANs, making the button dropdown list cumbersome to use.

Architecture, internals, and plumbing

Other bugs fixed

• 37305 Remove C4::Biblio::prepare_marc_host and use Koha::Biblio->generate_marc_host_field in preference

  25.11.00

  Sponsored by Open Fifth

• 38966 Wrong POD in Koha/CoverImages.pm and Koha/Acquisition/Order/Claims.pm
• 40079 C4::Scrubber “note” profile should allow for list (ul, ol, li, dl, dt, and dd) HTML tags
  

  This adds unordered, ordered, and description list tags (

  ,
  ,
  1. ,

     ,

     , and

     ) to the HTML that is allowed in notes fields (for example, course reserves staff and public notes).

  2. 40242 Typo in Quotes module
     This fixes a typo in the code for the quote of the day tool (there were two =>).
  3. 40261 Tidy build-git-snapshot
  4. 40277 Warn in C4::Koha::GetAuthorisedValues()
     This fixes the cause of an unnecessary warning message[1] in the logs when searching the OPAC when not logged in. (This warning was occurring when the OpacAdvancedSearchTypes system preference was set to something other than “itemtypes”, for example “loc”.)

     [1] Warning message:
     [WARN] Use of uninitialized value $branch_limit in concatenation (.) or string at …

  Authentication

  Other bugs fixed

  • 39206 Koha improperly tries to remove foreign cookies on logout (and in general the cookies aren’t actually removed, but set to empty values)

    This patch adds more control to Koha::CookieManager by allowing to refine its list of managed cookies with keep or remove entries in koha-conf.xml.

    IMPORTANT NOTE: The former (probably widely unused) feature of putting a regex in the do_not_remove_cookie lines is replaced by interpreting its value as a prefix. (So you should e.g. replace catalogue_editor_\d+ by just catalogue_editor_

  Cataloging

  Other bugs fixed

  • 39871 Cannot clear item statuses with batch item modification tool
  • 40128 StripWhitespaceChars can create empty subfields

  Circulation

  Other bugs fixed

  • 40107 Article requests: some DataTables functionality is broken

    This fixes JavaScript errors in the staff interface article requests table. The tables weren’t refreshing, and the tab numbers weren’t updating, when selecting an action for individual or multiple requests (such as ‘Set request as pending’).

    Sponsored by Athens County Public Libraries

  Command-line Utilities

  Other bugs fixed

  • 23883 sip_cli_emulator.pl – typo in parameter name
  • 40144 sip_cli_emulator.pl warnings

  Database

  Other bugs fixed

  • 40109 Path to fix_invalid_dates.pl is incorrect in fix_invalid_dates.pl and search_for_data_inconsistencies.pl

    This fixes a path in a hint in the search for data inconsistencies script (search_for_data_inconsistencies.pl) – misc/cronjobs/fix_invalid_dates.pl should be misc/maintenance/fix_invalid_dates.pl.

  ERM

  Other bugs fixed

  • 38899 Allow the Vue toolbar to be sticky

    This restores the sticky toolbar when adding a vendor in the acquisitions module (Acquisitions > + New vendor). This is related to bug 38010, which migrates vendors in the acquisitions module to using Vue – the sticky menu was not included in this.

  • 39951 Column filters are offset in ERM

  Hold requests

  Other bugs fixed

  • 39912 RealTimeHoldsQueue should be rebuilt when a holds pickup location is changed
  • 40118 Regression – ‘Holds to pull’ library filters don’t work
  • 40122 ‘Holds to pull’ library filters don’t work if library name contains parenthesis

    This fixes the holds to pull page so that the dropdown library filter works if the library name contains parenthesis (Circulation > Holds and bookings > Holds to pull).

  I18N/L10N

  Other bugs fixed

  • 20601 Untranslatable strings in circulation statistics

    This fixes and enhances the circulation statistics report wizard:

    • Fixes some strings so that they are now translatable
    • Fixes the patron library dropdown list so that it now works
    • Improves the “Filtered on” information shown before the report results:
      . the filtered on options selected in the report are now shown in bold
      . descriptions are now shown instead of codes (for example, the library name instead of the library code)

    Sponsored by Athens County Public Libraries

  ILL

  Other bugs fixed

  • 40171 ILL Patron Has No Email Address on File message upon “Send Notice To Patron”

  Label/patron card printing

  Other bugs fixed

  • 34157 Exporting labels as a barcode range can cause a 500 error

    This fixes the “Error 500…” message generated when printing barcode ranges using the label creator, where the layout type selected is “Bibliographic data precedes barcode” (Cataloging > Tools > Label creator).

  MARC Authority data support

  Critical bugs fixed

  • 40092 Clicking save doesn’t fill auto-populated fields in authority and biblio editor

    This fixes a regression between Koha 24.11, and 25.05 and main. When adding a new authority or bibliographic record, clicking save (without filling in any fields) now restores filling in the auto-populated fields such as 000, 003, and 008.

  OPAC

  Critical bugs fixed

  • 38102 Checkout history in OPAC displaying more than 50 items

  Other bugs fixed

  • 39223 The OPAC browse search (opac-browse.pl) is broken since 24.11

    This fixes the OPAC browse search feature (OpacBrowseSearch system preference, Elasticsearch only). Expanding and collapsing the search results to show the details now works, instead of nothing happening.

  Packaging

  Other bugs fixed

  • 40039 Add production enhancements to build-git-snapshot tool

  Patrons

  Other bugs fixed

  • 34776 Patron messaging preferences are lost when an error occurs during new account creation

    This fixes creating a new patron – the messaging preferences are now remembered if there is an error when creating a new patron. Before this, if there was an error when creating a patron (for example, the wrong age for the patron category), the messaging preferences (either the default or changes made) were emptied and needed to be re-added.

    Sponsored by Koha-Suomi Oy

  • 39498 Correct display of patron restriction comments

  • 40116 Extra popup notice when saving a patron with patron guarantor ends in error

    This patch changes existing guarantors elements in the patron add form to use classes “guarantor_id” and “guarantor_relationship” to prevent an unnecessary pop-up if the form throws an error.

    Sponsored by Koha-Suomi Oy

  • 40281 Patron circulation history page – type column is not hidden

    This fixes the patron circulation history page. The ‘Type’ column should not be shown, and is now hidden.

  REST API

  Other bugs fixed

  • 39657 Block holds placed via the API when patron would be blocked from placing OPAC hold

    This development adds more holdability checks to the POST /holds endpoint. Overrides are added for all of them:

    • bad_address
    • card_lost
    • debt_limit
    • expired
    • hold_limit
    • restricted

    Before this development, only any could be passed as an override. It will now have more granularity.

  • 40254 POST /holds override logic problem

  Reports

  Other bugs fixed

  • 39534 Saved report subgroup filter not hidden correctly

    Sponsored by Athens County Public Libraries

  SIP2

  Other bugs fixed

  • 32934 SIP checkouts using “no block” flag have a calculated due rather than the specified due date

  Searching – Zebra

  Other bugs fixed

  • 40304 Zebrasrv config doesn’t consider non-AMD64 CPUs

  Serials

  Other bugs fixed

  • 39997 List of closed serials: reopening requires the syspref “RoutingSerials”

  Staff interface

  Critical bugs fixed

  • 40127 JS error on biblio detail page when there are no items

    This fixes a JavaScript error on bibliographic record pages in the staff interface, where the record has no items.

  Other bugs fixed

  • 39939 Cancel selected holds button on the holds awaiting pickup page is the same color as the background

    This fixes the cancel selected holds buttons on the holds awaiting pickup page (under the tabs) (Circulation > Holds > Holds awaiting pickup). The light grey background was removed, and you can now see the cancel selected holds buttons.

    It also links the TransferWhenCancelAllWaitingHolds system preference under the “Holds waiting past their expiration date”, if the staff patron has permission to change system preferences.

    Sponsored by Athens County Public Libraries

  • 40250 Wrong link to NoIssuesChargeGuarantorWithGuarantees in patron category page
  • 40421 Logged in info should be data-attributes instead and text

    This patch adds HTML data-attributes to some hidden content in the staff interface. This makes it easier to retrieve context about the logged in user with CSS or JavaScript.

  System Administration

  Other bugs fixed

  • 40088 Do not show edit button for default framework

  Templates

  Critical bugs fixed

  • 40161 New translation not displayed when translating an item type

  Other bugs fixed

  • 32284 Capitalization: Audio Carriers, Computer Carriers … in UNIMARC value builders
    

    This fixes the capitalization for the labels displayed in the MARC tag editor for UNIMARC subfields 181$a, 181$c, $182$a, 182$c, and 183$c, when the value builders are used. The labels are changed from capital case to sentence case, for consistency with other labels:
    – Content Form -> Content form (181$a)
    – Content Type -> Content type (181$c)
    – Media Type Code -> Media type code (182$a)
    – Media Type -> Media type (182$c)
    – In the dropdown list (183$a):
    . Audio Carriers -> Audio carriers
    . Computer Carriers -> Computer carriers
    . Microform Carriers -> Microform carriers
    . Microscopic Carriers -> Microscopic carriers
    . Stereographic Carriers -> Stereographic carriers

  • 32287 Capitalization: Printing and/or Publishing Information Transcribed as Found in the Colophon:␠
    This fixes the capitalisation for the labels displayed in the OPAC and staff interface for UNIMARC subfields 214$r and $s – these are changed from capital case to sentence case, to be consistent with other labels:
    – 214$r: Printing and/or publishing information transcribed
    as found in the main source of information
    – 214$s: Printing and/or publishing information transcribed
    as found in the colophon
  • 32296 Capitalization: Specification of Dimensionality,…
    This fixes the capitalization for the labels displayed in the MARC tag editor for UNIMARC 181$b, when the value builder unimarc_field_181b.pl is used. The labels are changed from capital case to sentence case, for consistency with other labels:
    – Specification of type (position 0)
    – Specification of motion (position 1)
    – Specification of dimensionality (position 2)
    – Sensory specification 1, 2 and 3 (positions 3 to 5)

  • 39441 Some templates have div.container instead of div.container-fluid

    This updates a few templates so that div.container is replaced with div.container-fluid. div.container has a fixed maximum width that isn’t consistent with the rest of Koha. An example where this caused display issues – the staff interface cart: the action icons were bunched up to the left, instead of being spread evenly across the pop-up window width.

    Sponsored by Athens County Public Libraries

  • 39954 Cataloging search results incorrect menu markup

    Sponsored by Athens County Public Libraries

  • 40111 Fix title sorting on two reports

    Sponsored by Athens County Public Libraries

  • 40160 Use HTTPS for links to community websites
  • 40244 Typo in branchoverdues.tt

  • 40249 “Copy settings” should be “Copy permissions”

    This bug changes the phrase “Copy settings” to read as “Copy permissions”.

    Sponsored by Athens County Public Libraries

  • 40319 Fix spacing in address display include

    Sponsored by Athens County Public Libraries

  Test Suite

  Other bugs fixed

  • 18772 t/ImportBatch.t generates warnings
  • 40043 Agreements_spec.ts is failing randomly (2)
  • 40046 Remove wait and screenshot from Tools/ManageMarcImport_spec.ts
  • 40168 afterEach not called in KohaTable cypress tests
  • 40169 Cypress tests – mockData should not replace “_id” fields if passed
  • 40316 selenium/regressions.t generates warnings
  • 40317 Auth_with_shibboleth.t generates warnings
  • 40344 KohaTable_spec.ts is failing
  • 40347 Koha/Hold.t generates diag
  • 40348 api/v1/two_factor_auth.t generates warnings
  • 40350 t/db_dependent/Holds.t generates warnings
  • 40351 Koha/SearchEngine/Elasticsearch/Search.t generates a warning
  • 40353 Koha/Patron.t generates warnings
  • 40372 api/v1/holds.t generates a warning
  • 40373 Reserves.t generates a warning
  • 40374 Koha/Booking.t generates warnings
  • 40376 AuthorisedValues.t generates a warning
  • 40377 HoldsQueue/TransportCostOptimizations.t generates warnings
  • 40378 api/v1/biblios.t generates warnings
  • 40379 t/db_dependent/www tests generate warnings
  • 40380 Koha/Patrons/Import.t generates warnings
  • 40381 Koha/SearchEngine/Elasticsearch/ExportConfig.t generates warnings
  • 40384 Koha/Plugins/Patron.t generates warnings
  • 40385 Reserves/CancelExpiredReserves.t generates a warning
  • 40388 t/Labels.t generates a warning
  • 40389 t/dummy.t is useless
  • 40390 t/db_dependent/Biblio.t generates warnings
  • 40402 xt/find-license-problems.t is failing
  • 40403 Circulation_holdsqueue.t generates warnings
  • 40404 t/Test/Mock/Logger.t generates warnings
  • 40406 selenium/basic_workflow.t generates warnings
  • 40409 t/db_dependent/Overdues.t generates warnings
  • 40410 Letters.t generates a warning
  • 40411 Koha/SearchEngine/Elasticsearch.t generates warnings
  • 40419 xt/find-license-problems.t isn’t catching all instances of 51 Franklin St/Street
  • 40429 Koha/Patron/Modifications.t generates warnings
  • 40437 Koha/Installer.t generates a warning
  • 40438 Koha/Old/Hold.t generates warnings

  Tools

  Critical bugs fixed

  • 39289 Batch extend due date tool only displays the first 20 checkouts

  Other bugs fixed

  • 40332 Tools menu sidebar category not shown for users with batch_extend_due_dates only

  Enhancements

  Accessibility

  Enhancements

  • 40330 Accessibility of the OPAC Labels

  Acquisitions

  Enhancements

  • 31632 Add ability to manually link orders to suggestions

    This enhancement allows library staff to link an order (in an unclosed basket, or a standing order) to an accepted suggestion.

    Sponsored by Pymble Ladies’ College

  Architecture, internals, and plumbing

  Enhancements

  • 40101 Add Koha::Patron->can_place_holds
  • 40337 checkprevcheckout must be defined as ENUM at DB level

  Cataloging

  Enhancements

  • 39545 Construct more complete 773 content when creating a child record

    Sponsored by Open Fifth

  Circulation

  Enhancements

  • 39881 Add patron card number to the ‘On hold for’ column on the transfers to receive page

    This enhancement adds the patron’s card number to the transfers to receive page for patrons shown in the ‘on hold for’ column, for item-level holds (Circulation > Transfers > Transfers to receive).

  Developer documentation

  Enhancements

  • 40458 Discharge.pm is missing pod coverage

  Hold requests

  Enhancements

  • 38939 Add reservenote to members/holdshistory.pl

    This enhancement add a ‘Hold note’ column to the patron’s hold history table. It is configurable via administration’s Table settings.

  ILL

  Enhancements

  • 38928 Openurl ‘id’ or ‘rft_id’ may contain key information

  OPAC

  Enhancements

  • 38792 Move “My virtual card” tab and maybe re-label it

    Sponsored by Athens County Public Libraries

  • 39411 Add card number and patron expiration info to OPAC Virtual Card
  • 40129 Always show the “Not finding what you’re looking for” links in opac-results.tt

  Packaging

  Enhancements

  • 40164 Add Template::Plugin::JSON to handle JSON in Template Toolkit

    This patch adds a new Template::Toolkit library to Koha’s dependencies. This library, while not directly used in Koha, can be used in Template::Toolkit-driven templates to access JSON structures (e.g. notices, report templates, etc).

    A good example is making report templates that include JSON columns, like background_jobs.data.

  REST API

  Enhancements

  • 40176 Add maxLength to the item definition
  • 40177 Add maxLength to the library definition
  • 40178 Add maxLength to the patron definition
  • 40179 Add maxLength to the patron’s category definition

  Searching

  Enhancements

  • 33729 Add a column for dateaccessioned to item search results
  • 36947 Sort Elasticsearch/Zebra facets according to configurable locale instead of using Perl’s stringwise/bytewise sort

  Templates

  Enhancements

  • 39448 Layout improvement for search filter administration

    Sponsored by Athens County Public Libraries

  • 40172 Remove jQuery from js/fetch/http-client.js

  Test Suite

  Enhancements

  • 39876 Centralize listing of files from our codebase
  • 40170 Replace cypress-mysql with mysql2
  • 40401 Implement Koha::Patron->is_anonymous (was t/db_dependent/Auth.t generates warnings)
  • 40407 Remove legacy “pre-wrap” versions (was Patron/Borrower_Discharge.t generates warnings)

  New system preferences

  • FacetSortingLocale

  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 (73%)
  • German (97%)
  • Greek (99%)
  • Hindi (70%)

  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:

  • Arabic (ar_ARAB) (93%)
  • Armenian (hy_ARMN) (100%)
  • Bulgarian (bg_CYRL) (100%)
  • Chinese (Simplified Han script) (84%)
  • Chinese (Traditional Han script) (98%)
  • Czech (65%)
  • Dutch (86%)
  • English (100%)
  • English (New Zealand) (62%)
  • English (USA)
  • Finnish (99%)
  • French (99%)
  • French (Canada) (97%)
  • German (99%)
  • Greek (66%)
  • Hindi (95%)
  • Italian (79%)
  • Norwegian Bokmål (71%)
  • Persian (fa_ARAB) (94%)
  • Polish (99%)
  • Portuguese (Brazil) (95%)
  • Portuguese (Portugal) (87%)
  • Russian (92%)
  • Slovak (59%)
  • Spanish (98%)
  • Swedish (87%)
  • Telugu (66%)
  • Tetum (51%)
  • Turkish (81%)
  • Ukrainian (71%)
  • Western Armenian (hyw_ARMN) (61%)

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.02 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.02

We thank the following individuals who contributed patches to Koha 25.05.02

We thank the following libraries, companies, and other institutions who contributed
patches to Koha 25.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-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 24 Jul 2025 20:50:14.