.. include:: images.rst

Create a patron
___________________

A superlibrarian patron user is required to log into the Koha staff interface, once the onboarding process has been completed.

.. note:: It is very important to document the username and password created here as they are the account credentials required to login as an administrator (superlibrarian) of Koha.

You will need to input/select:

* Surname
* First Name
* Card number
* Library
* Patron category
* Username
* Password

.. figure:: images/create_patron_1.*
   :alt: Create a patron

   Create a patron


1. **Surname:** Surname, or something descriptive
2. **First name:** First name, or something descriptive
3. **Card Number:** Auto generated by the tool, it can be edited but it must be unique.
4. *Library* dropdown box: If a library has been created using this onboarding tool, it will be the only option. Otherwise select a random library from the sample libraries installed by the web installer.
5. *Patron category* dropdown box: If a patron category was created using this onboarding tool, it will be the only option. Otherwise select the *Staff* patron category.
6. **Superlibrarian permission:** This non-editable setting allows access to all librarian and web based Koha administration tasks in the staff interface. This user is the most powerful user in any Koha, so protect the credentials well.
7. **Username:** The username to log into the staff interface and OPAC (Online Patron Access Catalogue) with.
8. **Password:** A password consisting of letters, numbers, and spaces only which is greater than 8 characters.
9. **Confirm password:** Repeat the above password again
10. Click the *Submit* button to create the patron account

For example:

.. figure:: images/create_patron_1_example.*
   :alt: Create a patron example

   Create a patron example

------------------------------------------------


**Common errors creating patrons**


.. warning::
  After clicking on the *Submit* button there may be errors displayed.

.. figure:: images/create_patron_error.*
   :alt: Common patron creation errors

Common patron creation errors

1. **Cardnumber already in use:** This means that someone already has the card number previously entered. Cardnumbers are unique values, so enter a higher card number value.
2. **Passwords do not match:** The passwords in the **Password** and **Confirm password** fields do not match.

Just click the *Try again* button and fill out the form again making sure to enter a higher number for the **Card number** and the identical password in both the **Password** and **Confirm Password** fields.