Patron Search

Enhancing Koha Patron Search with Notes

Patron Search

Patron search is a valuable tool for staff to look for patrons fitting a defined criteria. It is important to understand exactly how this feature works. With improper settings a patron search can inadvertently cause too much strain on your Koha system. Accessing patron search can be done from the search bar (uses auto complete to search as you type) and from the patron module. Both patron searches allows you to enter the following:
  1. Search: Enter the information you are looking for (examples: name, email, barcode).
  2. Search Fields: Select the field within the patron record that you want to search.
  3. WarningWarning: Selecting 'Standard' in this field will search multiple fields at once as defined in the system preference DefaultPatronSearchFields. It is not recommended to change this system preference from the default choices of first name, last name preferred name, username, email address and barcode. Adding custom fields to the 'Standard' search can result in a slow or system crashing search particularly for large libraries with many patrons.
  4. Search Type: Choose between 'starts with' or 'contains'.
    1. starts with: returns only results where the search field starts with the information entered in the search. For example a search for first name 'Jo' will return Jo, Joe, and Josephine but not MaryJo.
    2. contains: returns results where the search field contains the information entered in the search. For example a search for first name 'Jo' will return Jo, Joe, Josephine AND MaryJo
    3. It is possible to change the default for search type with the system preference DefaultPatronSearchMethod.
  5. Category: Choose a patron category based on the available categories in Administration > Patron Categories 
    Notes
    Note: If a patron category has been limited to certain branches only those branches will see the option to search that category
  6. Library: Choose a library based on the libraries listed in Administration > Libraries

Known Issues

Default patron Search Fields

As mentioned above, changing the system preference DefaultPatronSearchFields is not recommended. There is Bug 39205 which would allow custom 'search fields' to be added without adding them to the standard search.

Koha is not currently weighting the patron search results which can result in inaccurate results even when an exact name is entered. This is documented in Bug 36226

Patron Reports

In some cases a report maybe the best way to search for a large defined group of patrons. The Koha Reports Wiki has a large selection of useful patron reports.

Relevant Koha Manual Sections

    • Related Articles

    • Managing Patron Accounts

      Koha has many options and tools for managing patron accounts. Customize the Patron Registration Form Libraries can customize which patron fields display on the form, which fields are mandatory and which fields are collapsed within the patron detail ...
    • Item Search

      If you’re responsible for Collection Development but SQL and creating custom reports feels intimidating and out of reach, Item Search is the powerful little tool you need. Item Search builds an SQL report in the background with no need to know SQL. ...
    • Advanced Searching in Koha

      Koha has a built-in 'Advanced Search' option which allows staff and patrons to build a search using search terms, item types, shelving locations, publication date, availability, location, and more! Staff Advanced Search If a staff member was looking ...
    • Patron Notes and Messages

      Notes and messages on patron accounts can be staff facing or patron facing. As of 24.05, custom emails can be generated from patron accounts. Using and customizing notes and messages is documented in the Koha manual. Internal notes and messages OPAC ...
    • Patron Passport Plugin for Koha

      This plugin is available on the ByWater Solutions GitHub site, and currently needs to be configured by a ByWater team member. The plugin configuration does not live in the staff interface, but on the backend where it is not accessible to partners. ...