RELEASE NOTES FOR KOHA 25.05.01

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

It includes 8 enhancements, 46 bugfixes.

System requirements

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

Bugfixes

Accessibility

Other bugs fixed

• 39475 WCAG 2.1: 1.4.10 – Content reflow – OPAC header menus

  This fixes some accessibility reflow issues in dropdown menus for the OPAC when larger text sizes are used (for example, 400%). It specifies the text-wrap behaviour, and by reducing line-height values in some places it makes dropdown items more distinguishable from each other. This includes:
  – Lists: a list with a very long name now wraps, instead of staying on one line that goes off the screen.
  – User menu (when logged in): the ‘Clear’ button next to ‘Search history’ now moves down to its own line.

Acquisitions

Critical bugs fixed

• 40066 Cannot add order to basket from the baskets view

  This fixes adding items to a basket – instead of getting the pop-up window to add to the basket, the message “You can’t create any orders unless you first define a budget and a fund.” was shown (Acquisitions > [vendor] > Baskets > Add to basket).

  (This is related to Bug 38010 – Migrate vendors to Vue, added to Koha 25.05.)

Other bugs fixed

• 40036 Purchase suggestion status column no longer displays reason

  This restores the display of suggestion accept or reject reasons (from the SUGGEST authorized values category) in the status column for the list of purchase suggestions. (This is related to Bug 33430 – Use REST API for suggestions tables, added in Koha 25.05.)

  It also adds classes for the SUGGEST authorized values, so that these can be styled.

• 40067 “Receive shipments” should not open in a new tab/window

Architecture, internals, and plumbing

Critical bugs fixed

• 40033 The background jobs page calls GetPlugins incorrectly, resulting in a 500 error

  This fixes the background jobs page (Koha administration > Jobs > Manage jobs) so that it doesn’t generate a 500 error when a plugin does not have a background task (it currently calls GetPlugins incorrectly).

Other bugs fixed

• 39834 Tabs need to be replaced with spaces

  This fixes several files by replacing tabs with spaces and makes the QA script happy!

• 39920 do_check_for_previous_checkout should us ‘IN’ over ‘OR’
• 40003 Warning generated when creating a new bib record
• 40034 CheckReserves dies if itype doesn’t exist
• 40087 Remove unused C4::Scrubber profiles “tag” and “staff”

Cataloging

Other bugs fixed

• 37364 Improve creation of 773 fields for item bundles regarding MARC21 245 and 264

  Sponsored by PTFS Europe

• 39991 Record comparison in vendor file – results no longer side by side

Circulation

Critical bugs fixed

• 38477 Regression: new overdue fine applied incorrectly when using “Refund lost item charge and charge new overdue fine” option in circ rules

  Under certain circumstances, the existence of a lost charge for a patron that previously borrowed an item (which was later found) could lead to creating a new fine for a patron that borrowed and returned the item with no issues – if the item was lost and found again after they had returned it.

  This adds tests to cover this edge case, and fixes this edge case to ensure that a new fine is only charged if the patron charged the lost fine matches the patron who most recently returned the item.

Other bugs fixed

• 39919 Overdues with fines report has incorrect title, breadcrumbs, etc.

  Sponsored by Athens County Public Libraries

Command-line Utilities

Critical bugs fixed

• 31124 koha-remove fails to remove long_tasks queue daemon, so koha-create for same user fails

  This development makes koha-remove stop all worker processes before attempting to remove the instance’s UNIX user.

Other bugs fixed

• 39887 Improve documentation of overdue_notices.pl
• 39961 koha-create doesn’t start all queues

ERM

Critical bugs fixed

• 39823 SUSHI harvest fails to display error if the provider’s response does not contain Severity

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.

ILL

Critical bugs fixed

• 40057 Database update 24.12.00.017 fails if old ILL data points to non-existent borrowernumber

  This fixes a database update related to ILL requests, for bug 32630 – Don’t delete ILL requests when patron is deleted, added in Koha 25.05.

  Background: Some databases have very old ILL requests where ‘borrowernumber’ has a value of a borrowernumber that doesn’t exist. We’re not exactly how the data ended up this way, but it’s happened at least twice now for one provider.

Other bugs fixed

• 39875 ILL – History check fails if unauthenticated request
• 40025 Standard ILL requests don’t update form when changing type in edit item metadata

  This fixes editing the item metadata for a standard ILL request. If the type (such as book or journal) is changed, the metadata is now updated for the selected type. Before this, matching metadata was not updated.

Label/patron card printing

Other bugs fixed

• 40061 Cannot delete image from patron card creator

  Sponsored by Athens County Public Libraries

MARC Authority data support

Other bugs fixed

• 40119 Merge should not leave empty 6XX subfield $2 (MARC 21)

  Sponsored by Ignatianum University in Cracow

MARC Bibliographic data support

Other bugs fixed

• 39558 Timestamps on biblio biblioitems and biblio_metadata are not in sync

OPAC

Critical bugs fixed

• 38974 Error when submitting patron update from the OPAC Can’t call method “dateofbirthrequired” on an undefined value

  This fixes updating personal details in the OPAC. A 500 error was shown if the “Patron category (categorycode)” was selected in the PatronSelfModificationBorrowerUnwantedField system preference and the date of birth field was changed or previously empty.

Other bugs fixed

• 40080 Course reserves details search appears offscreen

  This fixes the alignment of the OPAC course reserves search box – it is now on the left above the table, instead of offscreen on the right-hand side.

REST API

Other bugs fixed

• 39970 REST API – Creating a patron without mandatory attribute types does not error (it should)

Reports

Other bugs fixed

• 39866 Acquisitions statistics fails when filling only the To date

• 39955 Report subgroup filter not cleared when changing tabs

  Sponsored by Athens County Public Libraries

SIP2

Critical bugs fixed

• 39911 Fatal errors from SIP server are not logged

Self checkout

Other bugs fixed

• 40108 Self-checkout print receipt option not working

  Sponsored by Athens County Public Libraries

Staff interface

Critical bugs fixed

• 40002 Cannot filter patrons by “Browse by last name”

Other bugs fixed

• 39903 Catalog details page emits error if librarian cannot moderate comments on the record
• 39987 Batch item deletion breadcrumb uses wrong link
• 40166 Syspref description for ILS-DI:AuthorizedIPs is incorrect

System Administration

Other bugs fixed

• 37439 ChildNeedsGuarantor description misleading

Templates

Other bugs fixed

• 38127 Missing column headings in ‘Add user’ pop-up modal

  This fixes the “Add user” pop-up window when adding a user to a new order in acquisitions. The table now shows the column headings, such as card, name, category, and library.

  Sponsored by Athens County Public Libraries

• 39499 Add some padding to the Save button in the sticky bar in cataloging

  Sponsored by Athens County Public Libraries

• 39947 Use bg--subtle in preference to bg- Bootstrap classes

  This fixes some Bootstrap color classes.

  It removes a few instances of the “bg-*” class from templates (used in a few places such as bg-info, bg-danger, etc.) as the styles don’t really fit with the staff interface’s color palette. Examples include the circulation and fine rules page and the patron import tool page.

  In the places where we don’t want to use the corresponding alert classes, it adds some CSS so that we can safely use the “.bg-*-subtle” class to a div with “.page-section.”.

  (This is related to Bug 39274 – HTML bg-* elements are low contrast, added to Koha 25.05, and Bug 35402 – Update the OPAC and staff interface to Bootstrap 5, added to Koha 24.11.)

  Sponsored by Athens County Public Libraries

• 40042 search_indexes.inc may have undefined index var

Test Suite

Other bugs fixed

• 36625 t/db_dependent/Koha/Biblio.t leaves test data in the database
• 40018 Remove warning from Koha/Template/Plugin/Koha.t
• 40019 Koha/Auth/Client.t produces warnings
• 40020 Koha/AdditionalContents.t produces warnings
• 40021 Koha/Plugins/Recall_hooks.t produces warnings

Enhancements

Accessibility

Enhancements

• 39434 The pages are missing semantic tags that identify the regions of the pages.

Acquisitions

Enhancements

• 38298 EDIFACT breadcrumbs need to be permissions based

Architecture, internals, and plumbing

Enhancements

• 40055 C4::Reserves::MoveReserve should be passed objects

Lists

Enhancements

• 33440 A public list can be transferred to a staff member without list permissions

Notices

Enhancements

• 36020 Port default recall notices to Template Toolkit

  This enhancement adds recalls to the objects that can be called using Template Toolkit and updates the default notices for RETURN_RECALLED_ITEM, PICKUP_RECALLED_ITEM, and RECALL_REQUESTER_DET notices.

  It uses [% INCLUDE ‘biblio-title.inc’ biblio=biblio link=0 %] and [% INCLUDE ‘patron-title.inc’ patron => borrower, no_title => 1, no_html = 1 %] to pull in the title and patron information.

  Existing installations will not see changes to their notices but they can be viewed using the “See default” button when editing the notice.

OPAC

Enhancements

• 39925 Table columns missing headings for bibliographic search history in OPAC

  Sponsored by Athens County Public Libraries

Reports

Enhancements

• 23978 Notes field in saved reports should allow for (scrubbed) HTML

Templates

Enhancements

• 39948 Simplify unauthenticated ILL request detail in the OPAC

  This enhancement simplifies the unauthenticated ILL submission detail page for the OPAC. It removes ‘Unauthenticated …’ in front of the labels for the first name, last name, and email fields.

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 (98%)
• Greek (100%)
• 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:

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

We thank the following individuals who contributed patches to Koha 25.05.01

We thank the following libraries, companies, and other institutions who contributed
patches to Koha 25.05.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.

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 Jun 2025 17:07:53.