16. Notices

All notices sent by Koha can be customized using the Notices Tool. The system comes with several predefined templates that will appear when you first visit the Notices Tool

Each notice can be edited, but only a few can be deleted, this is to prevent system errors should a message try to send without a template.

16.1. Adding Notices

To add a new notice

  • Click 'New Notice'

  • Choose the module this notice is related to

  • The Code is limited to 20 characters

  • Use the name field to expand on your Code

  • Message Subject is what will appear in the subject line of the email

  • In the message body feel free to type whatever message you feel is best, use the fields on the left hand side to enter individualized data from the from database.

    • Important

      On overdue notices make sure to use <<items.content>> to print out the data related to all items that are overdue. The other option is to use the <item></item> tags to span the line so that it will print out multiple lines

    • Important

      Only the overdue notices take advantage of the <item></item> tags, all other notices referencing items need to use <<items.content>>

16.1.1. Notice Markup

When creating your overdue notices there are two tags in addition to the various database fields that you can use in your notices.


These new tags only work on the overdue notices, not other circulation related notices at this time.

  • <item></item> which should enclose all fields from the biblio, biblioitems, and items tables.

  • <fine></fine> which should be enclosed by the item tag and should enclose a currency identifier per ISO 4217. If this tag is present with a proper identifier, the fine for that item will be displayed in the proper currency format.

    • Note: ISO 4217 changes from time to time therefore all currencies may not be supported. If you find one that is not supported, please file a bug with the Locale::Currency::Format author Tan D Nguyen <tnguyen at cpan doe org>.

An example of using these two tags in a notice template might be like:

   The following item(s) is/are currently overdue:

   <item>"<<biblio.title>>" by <<biblio.author>>, <<items.itemcallnumber>>, Barcode: <<items.barcode>> Fine: <fine>GBP</fine></item>

Which, assuming two items were overdue, would result in a notice like:

   The following item(s) is/are currently overdue:

   "A Short History of Western Civilization" by Harrison, John B, 909.09821 H2451, Barcode: 08030003 Fine: £3.50
   "History of Western Civilization" by Hayes, Carlton Joseph Huntley, 909.09821 H3261 v.1, Barcode: 08030004 Fine: £3.50

16.2. Existing Notices

Among the default notices are notices for several common actions within Koha, here are some of what those notices do


    • Sent to patrons when their account is set up if the AutoEmailOPACUser preference is set to 'Send'

  • ACQCLAIM (Acquisition Claim)

    • Used in the claim acquisition module

    • Get there: More > Acquisitions > Late issues

  • HOLD (Hold Available for Pickup)

    • This notice is used if two criteria are met:

      1. The EnhancedMessagingPreferences is set to 'Allow'

      2. The patron has requested to receive this notice

        • Get there: OPAC > Login > my messaging

        • Get there: Staff Client > Patron Record > Messaging

  • HOLDPLACED (a notice to the library staff that a hold has been placed)

  • HOLD_PRINT (Printed notice when hold available for pickup)

    • This notice is used for hold confirmation notices that are sent out in print format. This will not effect what the email notice looks like.

  • ODUE (Overdue Notice)

  • RLIST (Routing List)

    • Used in the serials module to notify patrons/staff of new issues of a serial

    • You have the option to select the 'Routing List' notice when creating a new subscription (Choose from the 'Patron notification' drop down).

    • Tip

      Notice also that if you'd like to notify patrons of new serial issues, you can click on 'define a notice' which will take you to the 'Notices' tool