Circulation & patrons
Why Koha refuses a checkout, message by message
Every message Koha shows when it will not check an item out, what each one means, and the setting or the patron record you change to fix it.
By Babar Junaid
Published 2026-11-16 · Tested against Koha 26.05
When Koha will not check an item out, the message names the reason, and each reason has one place to fix it. A limit or a missing rule is fixed in Administration → Circulation and fine rules. A blocked patron is fixed on the patron record: renew an expired card, take a payment, or remove a restriction. Find your message below.
"Too many checked out. 0 checked out, only 0 are allowed."
Koha found a circulation rule for this patron and item, and that rule says 0 current checkouts allowed. Zero means none. A blank box means no limit. The line under the message names the rule Koha used, by library, patron category and item type. Go to that rule and correct the number:
- 1Go to Administration → Circulation and fine rules and pick the library the message names (or All libraries).
- 2Find the row for that patron category and item type and click Edit.
- 3Set Current checkouts allowed to the real limit, or clear it for no limit, and Save.
If the numbers are not 0, for example 5 checked out, only 5 are allowed, the patron has simply reached the limit. Return something first, or check that the limit is the one you meant.
Whether this refuses or only asks depends on the AllowTooManyOverride preference. On a new Koha it is Allow, so the message appears in a Please confirm checkout box and staff can lend anyway; set to Don't allow, the checkout is refused, and on Koha 26.05 the message loses its numbers: Too many checked out. checked out, only are allowed. The rule line under it still tells you which rule to fix. A limit of 0 adds a second line, This patron can't check out this item per library circulation policy., and is still only a confirmation while the override is allowed. We checked both settings on Koha 26.05.02.
If the count looks one too high, on-site checkouts are being counted: with ConsiderOnSiteCheckoutsAsNormalCheckouts on (the default), they use up the same limit. On-site checkouts have their own limit, and reaching it shows Too many on-site checked out instead.
Which library's rules apply
CircControl system preference decides that: the library you are logged in at (default), the patron's library, or the item's home library. A rule that looks right under one library does nothing when Koha is reading another's. When several rows match, the most specific one wins (a named library over All, a named category over All, a named item type over All)."No circulation rule is defined for this patron and itemtype combination."
No row matches at all, not even an All one. Add a default row: in Circulation and fine rules, choose All libraries and fill in the row with All patron categories and All item types. That row is the catch-all every other rule overrides.
"Item type not for loan." or "Item not for loan."
- Item type not for loan: the item type itself is marked not for loan. Clear Not for loan on it under Administration → Item types, or give the copy a lendable item type.
- Item not for loan(…): this one copy has a not-for-loan status, shown in brackets with no space before them, for example Item not for loan(Not for loan). or (Staff collection). Edit the item and set Not for loan back to the empty value.
If staff should be allowed to lend these anyway, set AllowNotForLoanOverride to Allow. The message then asks for confirmation instead of refusing.
"Patron's card has expired." / "Patron's card is expired"
The patron's expiry date has passed. The checkout screen says Cannot check out! and Patron's card has expired., and the barcode box is gone. Patron's card is expired is what you see if staff click Override restriction temporarily and scan a book. Renew the membership: the message on the checkout screen has a Renew link next to it, or use More → Renew patron on the patron's page. The new expiry date is the patron category's enrolment period, counted from the date set in BorrowerRenewalPeriodBase (today, the old expiry date, or whichever is later). To set a different date, edit the patron and change Expiry date.
"Checkouts are BLOCKED because fine balance is OVER THE LIMIT." or "Charges: Patron has outstanding charges of …"
The patron owes more than the limit. On Koha 26.05 the checkout screen does not print the OVER THE LIMIT line for the patron's own charges (its template tests a limit it is never given). It shows Cannot check out! with Charges: Patron has outstanding charges of 10.00., and no barcode box. The OVER THE LIMIT wording still appears when the debt belongs to a guarantor or guarantee, and on batch checkout. Koha uses the patron category's own Checkout charge limit when one is set, and the noissuescharge system preference otherwise. The block applies only when the balance is greater than the limit, so a limit of 5 still lends to someone owing exactly 5.
- Take a payment or write off the charge under the patron's Accounting tab, and the block lifts at once.
- To change the limit for one group of patrons, set it on the category (Administration → Patron categories) rather than changing the preference for everyone.
- To let staff lend anyway after a warning, set
AllowFineOverrideto Allow. Checkout then shows "The patron has a debt of …" and asks for confirmation.
"Patron is restricted"
The patron has an active restriction. The checkout screen says Cannot check out! and Account restricted since a date, with Indefinite restriction or Restriction expiring a date under it, and the barcode box is gone. After Override restriction temporarily, scanning a book adds Patron is restricted and Patron has a restriction until a date or Patron has an indefinite restriction. To lift it, open the patron, go to the Restrictions tab and click Remove. You need both the edit_borrowers and manage_restrictions permissions to see that button.
A restriction whose comment says it was added by the overdues process came from an overdue notice trigger. It is removed automatically when the items come back only if AutoRemoveOverduesRestrictions is set to do so; otherwise it stays until somebody removes it. A dated restriction from overdue fines (fine days in the circulation rules) ends by itself on its date.
Why Koha checks so many things
Every checkout runs one check over the patron (card expiry, lost card, address in doubt, restrictions, fines, overdues) and then the item (not for loan, withdrawn, lost, the circulation rule limit). Some failures stop the checkout outright. Others only ask for confirmation, depending on the override preferences above. That is why the same situation refuses at one library and only warns at another.
Most "it worked yesterday" reports come from the circulation rules, because they are layered. A new specific row added for one library or item type silently takes over from the general row that used to apply. When a message names a rule you do not recognise, someone added that row.
Other messages at the desk
| Message | Where to fix it |
|---|---|
| Patron's card is flagged as lost | Edit the patron, Patron account flags, set Lost card to No |
| Patron's address flagged as in doubt | Edit the patron, Patron account flags, set Address correction needed to No |
| Checkouts are BLOCKED because patron has overdue items | The OverduesBlockCirc preference: return the overdue items, or set it to ask for confirmation |
| This item belongs to … and cannot be checked out from this location | The IndependentBranches preference is on: only staff at the item's own library (or a superlibrarian) can lend it |
| Patron's account has been locked | Too many failed logins; changing the patron's password removes the lock |
Dates in these messages follow your date format setting, and due dates skip the days in the library calendar.
Tested on live Koha 26.05.02
Passed all 26 checks · Read the run log
- Koha release
- 26.05.02
- System
- Debian 13 (trixie)
- Setup
- Official Koha test container (koha-common commands). A command that needs systemd or a firewall says where it ran.
- Source read at
- Koha commit d3fc229
In the Koha manual (26.05)
Verified against the Koha source (8 files)
- C4/Circulation.pm (lines 431-711, 916-1160)
- koha-tmpl/intranet-tmpl/prog/en/modules/circ/circulation.tt (lines 159-243, 624-690)
- koha-tmpl/intranet-tmpl/prog/en/includes/patron_messages.inc (lines 27-47, 92-121, 159-161, 180-190)
- koha-tmpl/intranet-tmpl/prog/en/includes/blocked-fines.inc (lines 1-14)
- circ/circulation.pl (lines 678-706)
- Koha/Patron.pm (lines 3622-3660)
- Koha/CirculationRules.pm (lines 270-300)
- installer/data/mysql/mandatory/sysprefs.sql (lines 59, 187)
The label under each command says where its response came from; a command with no label was not run live. How we test and which standards we follow.
Desk still refusing checkouts? Tell us the exact message and the patron category, and we will find the rule behind it.
Related
More on circulation & patrons
Answers to the questions that usually arrive with this one.
How holds work in Koha, step by step
A hold goes through five stages: placed, picked from the shelf, confirmed at check-in, waiting for the patron, and filled at checkout. Here is each step and the Koha screen that does it.
How to print Koha slips and receipts on a thermal receipt printer or an A4 printer
Koha prints every slip through the web browser, so an 80 mm thermal roll and an A4 page printer are set up in the printer driver and one slip stylesheet, not in a Koha printer setting. Here is each step for both, tested on Koha 26.05.

