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 25.05.01 can be downloaded from:
Installation instructions can be found at:
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.
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.
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.)
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.
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).
This fixes several files by replacing tabs with spaces and makes the QA script happy!
37364 Improve creation of 773 fields for item bundles regarding MARC21 245 and 264
Sponsored by PTFS Europe
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.
39919 Overdues with fines report has incorrect title, breadcrumbs, etc.
Sponsored by Athens County Public Libraries
This development makes
koha-removestop all worker processes before attempting to remove the instance's UNIX user.
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.
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.
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.
40061 Cannot delete image from patron card creator
Sponsored by Athens County Public Libraries
40119 Merge should not leave empty 6XX subfield $2 (MARC 21)
Sponsored by Ignatianum University in Cracow
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.
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.
39955 Report subgroup filter not cleared when changing tabs
Sponsored by Athens County Public Libraries
40108 Self-checkout print receipt option not working
Sponsored by Athens County Public Libraries
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
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.
39925 Table columns missing headings for bibliographic search history in OPAC
Sponsored by Athens County Public Libraries
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.
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:
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 25.05.01 is
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.
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 25.05.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 24 Jun 2025 17:07:53.