Koha Upgrades

Fall 2021 Upgrade Webinars and Q&A


Each webinar covered the new features and enhancements that we are most excited to share with our partners for Koha versions 20.11 and 21.05. This agenda outlines what we discussed in both webinars.

What's New Webinar 1

Watch the recording of the What's New Webinar 1 held on October 13, 2021.

What's New Webinar 2

Watch the recording of the What's New Webinar 2 held on October 15, 2021.


This year we have two sessions scheduled to answer all of your upgrades questions! Registration is required, and you are welcome to attend one or both sessions.

Click on the session(s) of your choice to register:

Q&A session 1 - Register Now

Tuesday, October 26, 2021
2:00 p.m. to 3:00 p.m. Eastern
1:00 p.m. to 2:00 p.m. Central
12:00 p.m. to 1:00 p.m. Mountain
11:00 a.m. to 12:00 p.m. Pacific

Q&A session 2 - Register Now

Thursday, October 28, 2021
11:00 a.m. to 12:00 p.m. Eastern
10:00 a.m. to 11:00 a.m. Central
9:00 a.m. to 10:00 a.m. Mountain
8:00 a.m. to 9:00 a.m. Pacific

If you have any questions about the upgrades process, please open a ticket.

Questions and Answers

These questions were asked during What's New webinars and will be updated after the Q&A sessions on October 26 and 28.

OPAC & Public Services

[26123] Show info about existing OPAC note/Patron message on patron's dashboard

  • What messages... the ones in patrons' OPAC account or at the top of their account in the staff client? These are created using the 'Add a message' button on the patron's Details tab. Only 'OPAC - [patron's name]' messages will show for the patron in the OPAC. These are in black italic text on the staff interface. Messages marked as 'Staff - Internal note' are bold red italic on the staff interface and will not show on the OPAC.

Patrons & Circulation

[25534] Add ability to specifying and store a reason when cancelling a hold

  • What does "cancelled" mean? Could patrons tell if they didn't pick up -vs- item could not be found? Will it show the reason for the hold cancellation? If the authorized value specifies that it wasn't picked up (or any other reason), yes.
  • Can reasons be added easily? Yes - these are added as 'HOLD_CANCELLATION' authorized values.
  • So this is for staff to inform patrons of cancellations, not for patrons to cancel their own holds? Is this only one way? Can patrons give a reason why they cancelled? This is only for staff to notify patrons of the reason for a cancellation. There isn't currently a way for patrons to provide a reason for cancelling.
  • Is it mandatory to choose a reason? The default is 'No reason given' - there is a drop-down menu to select something else.
  • Can you set a default of "no message"? If a hold is cancelled with 'No reason given' selected, the patron won't receive a notice.
  • Did you say there is a syspref to ALLOW staff to see hold history? Yes, this is part of intranetReadingHistory: [Allow/Don't allow] staff to access a patron's checkout and hold history (checkout history is still stored, regardless of staff being allowed access or not).
  • Will the authorized values be for all libraries if you are in a consortium or can individual libraries choose their own? They can be limited by library or available for all! Use the 'Library limitations' box in your authorized values set-up to limit to one or more locations.

[12656] Allow a CANCELLATION_REASON to be specified on the cancel_expired_holds.pl job
  • Is this a patron messaging preference? No, but there is a bug that would make it one. Currently, Koha will attempt to send this to all patrons if enabled.

[14866] Make high holds work with different item types and number of open days

  • What about customizing hold length based on item type? This isn't currently possible.
  • Could you do this for an entire collection such as Holiday Books? No, it is by patron category/item type combination only.
  • Can a loan period for a item type be a number of hours? Yes! The 'Unit' column in the circulation matrix can be set to days or hours.

[22789] Establish non-priority holds

  • Do Non-Priority Holds count against the "Total Holds Allowed" count? Yes.
  • Does non-priority status show on the patron side? No.
  • Can you set the default for Non-Priority as "yes" for a specific branch or patron type? This isn't currently possible.
  • How would this interact with Club Holds? This can’t currently be set for club holds.
  • Do patrons set this when they place their own holds? No, only staff can designate holds this way.

[23091] Add options to charge new or restore forgiven overdues when a lost item is returned

  • Would it also forgive the processing fee? (We don't charge overdues but we do charge item + $5. and then it only forgives the item) No, it is the item cost only.
  • So if the library has no late fees, there will be no charge [if the lost item fee is refunded on return]? Correct!
  • Is there a way to have this apply to a single item type? For instance, we only have overdue fines for technology. It will work based on the overdue fines set in your circulation matrix, so it should apply by those patron category/item type combinations only. If there are only overdue fines for one item type, there won't be anything to restore/charge for other items.

[23916] Issuer should be recorded and visible in patron circulation history

  • Is checked out by retro, or only for transactions going forward? It won't show retroactively/until the system preference recordStaffUserOnCheckout is enabled, but the issuer is visible in your logs.
  • Does it let you know which staff member checked in an item as well? No, but that is available in your logs.
  • Does that show to patrons also? It does not.
  • How does it know who to show? It shows based on the logged-in staff member, so if multiple staff share a login, it won't tell you the individual. (This is a great reason to not use shared logins!)
  • Do we have to turn this on or will it just be there? By default, recordStaffUserOnCheckout will be off - you will need to enable it.

[25261] Multiple parts handling confirmation alert

  • What does this [the pop-up] do to RFID check in? We could not test that but think that they won’t work well together since you have to click the confirmation box for each item.
  • Is this only added at cataloging or can it be edited later depending on permissions? It can be edited with permissions.
  • Will it not truly check it in until we have checked "yes"? Staff must click 'Yes' to complete the check-in.
  • I assume we can add an audio alert for this. Yes, you can! This Monday Minutes: Audio Alerts post details setting up and customizing alerts.
  • Please remind me where the note that pops up gets put. It goes in 952$3-Materials specified (bound volume or other part). The system preference circConfirmItemParts must also be enabled.
  • There's an item type 'Checkin message' - does this new feature work with that part of the item type record? A 'Checkin message' at the item type level DOES NOT trigger the parts confirmation popup.

Technical Services

[23019] Ability to create ‘matching profiles’ when importing records

  • Will this also work with authorities? Yes!
  • Those profiles are system wide not just by user? Yes, they are for the system (not just the user or logged-in library).
  • Since everyone can see, can one library edit another library's profile? Yes, any changes will be saved over the original profile - there is no prompt to save with a new name.
  • Are there controls for the ability to create/edit these profiles? Yes, this is controlled by the stage_marc_import permission.

[23420] Add “SuggestionsUnwantedFields” to hide fields from the suggestions form

  • Could those unwanted suggestions be in the patron creation as well? They are! BorrowerUnwantedField controls the staff interface patron entry screen, PatronSelfRegistrationBorrowerUnwantedField controls the patron self-registration field, and PatronSelfModificationBorrowerUnwantedField controls patron self-modification on the OPAC.

[26630] Allow custom text for each library on the purchase suggestion page

  • What about message changes by group? Currently this can only be set to individual libraries or all libraries, but not groups.

[8976] Default sequence of subfields in cataloguing and item editor

  • Any way to put the subfields of authority records into a default order? Yes, using the same drag-and-drop method. Authority frameworks can be edited via Administration--Authority Types, then viewing the MARC structure and then subfields of the tag you wish to edit. Click the Edit button of any subfield to access the tabs for rearranging.
  • Will the re-ordering of the subfields carry over to the OPAC display -- that is, will the subfields appear in that order in the patron view? They will show on the OPAC MARC view.
  • Is this going to change the order of existing records that use that template? It will not at the bib level, but will for the item level and authority records. You can drag and drop subfields in existing bib records, and they should save/display in the new order.
  • Does this apply to batch imports? In testing, this didn’t put batch imports into the new order even with the default framework applied.
  • If we import the 952 field with subfields in a specific order, will they still go into the proper subfields or will they be saved out of order? Will I need to worry about this as a source of new errors? They should still save in the proper order since imports match on the tag/subfield itself, not the order.

Other questions

  • Is it true that bootstrap is changed, and IDs are majorly changed, especially for the OPAC? Yes Bootstrap changed. It was a big change for us as we have lots of customizations that hook on Bootstrap classes. If you're using Bootstrap selectors in your JS then they will need to be updated & some places you can only use layout selectors to grab certain parts of the page.
  • I ponder if there is a way for us to look at stuff and see if there is stuff that needs money that I can just browse. Like I can go shopping to spend my development money by seeing other projects pending money. Is there an organized way to do that? Yes! Visit http://devs.bywatersolutions.com/

Upgrade Resources

Learn more about 20.11 and 21.05 at the links below!

Koha Upgrade for Fall 2021
Koha 21.05 Upgrade Notes
Koha 20.11 Upgrade Notes
Fall 2021 Upgrades Blog Posts and Tutorial Videos

Read more by Sara Brown

Tags 20.11, 21.05, upgrade webinars