Skip to main content
Ex Libris Knowledge Center

Additional Settings

To configure other settings, you must have one of the following roles:
  • User Administrator
  • General System Administrator
For Alma users, the additional settings are common between Esploro and Alma, and can be edited in either product. This means that changes to the additional settings will be reflected in Alma, and the converse (from Alma to Esploro). 

Additional User Settings

You configure various user management customer parameters on the Customer Parameters mapping table (Configuration Menu > General > Additional Settings). For more information about mapping tables, see Mapping Tables.
Additional Settings for Esploro.
Customer Parameters Mapping Table Page (Additional Settings)
The following table describes the parameters you can configure on this page:
User Management Configuration Parameters
Parameter Key Description
address_lineX_regex (lines 1-5) The valid format of lines 1-5 in the user's street address. See Adding User Contact Information.
disable_from_address Set to true to disable the From: address field when you have configured a value for from_address (see below). This prevents users from entering their own email address in place of the one you have set in from_address. See Editing Users.
email_regex The valid e-mail format. See Adding User Contact Information.
email_regex_display The message appearing when entering an email address, if email_regex is defined.


For institutions whose Student Information System (SIS) does not offer authentication services, it is now possible to create users as external in Esploro/Alma, but assign passwords for them directly in Alma. In this case, all the user information, such as name, ID, etc, is managed from the SIS, but the passwords are stored in Esploro/Alma and managed by the Ex Libris Identity Service.

When this behavior is enabled, changing a user from external to internal (and vice versa) does not reset the user password; the existing password the user used as an external user is retained.

See Registering Patrons and Mapping User Accounts to Other Systems.

from_address The value used as a default in the From: address for the General Message you can send while editing a user. See Editing Users. See also disable_from_address, above.

Whether to enable walk-in services in a fulfillment network for patrons that don't happen to have an ID available. The parameter must be enabled at the institution where the patron is already registered.

Valid search criteria include first name, last name, or email address. The search must be an exact match. If the search yields more than one result, an error is returned.


Whether a fulfillment network uses unique user identifiers: 

  • FULL - Identifiers are unique across all members of the fulfillment network and are not duplicated. In Manage Patron Services a Find user in all network institutions check box will cause Alma to search for the ID first in the local institution and if not found then in all other participating institutions. Alma will automatically find the user record at any of the network institutions and pull its information from its institution. When selecting this option, the Find user in all network institutions check box should only be selected with searching for a unique patron ID across the entire network.
  • NONE – Identifiers are not unique. This is the default.
network_user_profiles_and_assignment_rules_distribution_members_behavior Controls what is done with the members' user profiles and assignment rules when the Network Zone's records are distributed. Valid values are: Remove and None. Remove removes all the local records. When set to None (the default), all previously existing records are left exactly as they were before the distribution.
phone_regex The valid phone number format. See Adding User Contact Information.
phone_regex_display The message displayed when entering a phone number, if phone_regex is defined.
photo_identifier_type The type of user identifier from which to take the name of the photo (together with photo_server_url). The options are: USERNAME (the primary identifier) or a user identifier code; see Viewing Additional User Identifier Types . See Managing User Pictures.
The URL directory for user photos to display in the User Details page. See Managing User Pictures.
  • The URL may use HTTP or HTTPS. To use HTTPS, the certificate must not be self-signed: it must be signed by a known certificate authority (the list of supported certificates can be found here).
  • The directory name must end with a forward slash (/) .
  • To view the photos in the User Details page, the user accessing the page must also have access to this URL.
photo_suffix The file extension (such as .jpg or .gif) for user photos. This value is appended to photo URLs – if this value is not defined, the photo may not appear properly. See Managing User Pictures.
pin_number_method To enable the PIN number generation functionality, enter the value fourDigit (the only possible value) here. See the PIN number field in Adding Users.
postal_code_regex The valid format for the postal code. See Adding User Contact Information.
By default, the postal code must be between 0 to 16 characters and must include only digits, capital letters, hyphens, and spaces. If you want to include periods as well, add \. following the hyphen, as follows: [A-Z0-9\-\. ]{0,16}
postal_code_regex_display The message displayed when entering a postal code, if postal_code_regex is defined.
preferred_identifier Enter an identifier code to be used when displaying only one identifier and when scanning items that are on the hold shelf according to user. The identifier codes are listed in the User Identifier Types page. For more information, see Viewing Additional User Identifier Types .
primary_identifier_regex The valid format of the primary identifier. Alphanumeric characters in primary identifiers are supported.

The retention period for the public IP address of users that logged into Alma. The default period is 90 days, you can state any number, including 0 to prevent retention. For details, see Staff Login Report

url_regex The valid format of the URL. It must have a leading protocol, a valid domain name (two or three letter TLD and no invalid characters), and a valid file path.
user_audit_retention_period Entering a whole number indicates a length of time, in days, that user audit trail records will be retained. The default value of spaces means that all records are retained. See User Audit History.
  • Was this article helpful?