To enable Aspen LiDA for your library, head to the Aspen LiDA module within Aspen Administration and click Location Settings. Then, click Add New.

1. Give the app setting a name. This will not appear anywhere in the app and is only for internal use.
2. Check the box for Display location(s) in Aspen LiDA.
3. Switch the Release Channel from Beta (Testing) to Production (Public)
4. Check all locations you'd like to show within LiDA.
5. Save your changes.

Once enabled, your library locations will appear in Aspen LiDA shortly. 

Note: there is currently no way for libraries to use LiDA in a test environment.

For certain library barcode lengths, it may be necessary to enable automatic rotation on the library card screen to flip to landscape mode.

To enable this, go to Aspen Administration > Aspen LiDA > General Settings > check Automatically rotate the library card screen to landscape > apply to Libraries

Settings within these Aspen LiDA General Settings area apply at the Library System level.

Address, Phone, and Location Email

Aspen LiDA pulls this information from Aspen Administration > Primary Configuration → Locations. 

1. Make sure the location's address, phone number, and email address are filled out on this page.
2. Do not complete the latitude and longitude fields, save them as blank and the Google Maps API will load in the correct values for you. If for any reason you change the library’s address, please blank these values before you save the new address so they can be reset.

Location Image

To add a location image, head to Aspen Administration > Primary Configuration → Locations. 

This image will appear in LiDA on the contact information screen for the library. This can be accessed by clicking on the More tab, then clicking the location name/hours at the top of the screen.

Aspen LiDA pulls from your library contact information in Aspen Administration > Primary Configuration → Library Systems → Contact Links → General Email Address.

You can either provide email addresses specific to the locations (as mentioned in the previous section) or you can specify a general contact email within the systems settings. If a location email is provided, LiDA will use that. If a location email is not provided, LiDA will use the general contact email. If a general contact email is not provided, LiDA will not display an email link on the contact screen.

Theme & Layout → Themes

The logo that shows in the "Find Your Library" menu will pull from the Favicon icon in the Theme since it is a smaller image file that will render much quicker.

For the logo that shows in the patron account drawer, it will check the "Logo for Aspen LiDA". If there is not a logo uploaded here, Aspen will look to see if there is a Favicon icon to use instead. The image should be square with a 512 x 512 pixel maximum. 

If the Favicon is loaded but the Logo for Aspen LiDA is not loaded, the Favicon will be used to display in both areas.

If a Favicon is not loaded, no image will show in "Find Your Library".

If neither a Favicon nor Aspen LiDA image is uploaded, for the patron account, Aspen will look to the logo uploaded in Aspen LiDA > Branded App Settings for the branded app. If no logo is loaded there either, it will default to the Aspen LiDA general logo. In the community app, it will also default to the Aspen LiDA general logo. 

The same rules apply for the logo on the digital library card.

For best practices, you can upload both the Favicon and the Logo for Aspen LiDA. Or, just the Favicon if they are going to be the same logo.

For Aspen LiDA logos, since they are a smaller size, it might be best to crop out words where possible and just use a recognizable image from the logo to clearly brand the library system/location.

To learn more about System Messages, visit our System Message Help Center page.

Create a system message

When setting up a System Message in LiDA, you are using the same Aspen Discovery System Message module but you can have the messages set to show in both places or one or the other.

1. Visit Aspen Administration > Local Catalog Enrichment > System Messages and click Add New.
2. Give your system message a title. This is not shown anywhere publicly, it is for your internal identification purposes only.
3. Type and format your message in the Message to show text area. You can change the font, color, size of font, add hyperlinks or even upload images here. If uploading images, keep in mind the size (smaller images might be better)
4. Check Display in Aspen LiDA if you want the message to show in Aspen LiDA
5. If showing in Aspen LiDA, add the message you want to show here. LiDA only supports text-only messages so you may want to modify/reduce what you have in your Discovery message.
6. Click the Show On dropdown to change where the system message displays, if desired. The message will show on All Pages by default (top of header placement), but you can also target messages based on whether users are logged in, or display on specific account pages.
7. Select a Message Style to help your message stand out with background colors. See below for examples.
8. Select a Start Date to Show and End Date to Show for your message if you only want the message to show during a specific time period.
9. Check Dismissable to allow logged in patrons to be able to hide a message if they have already seen it. All Aspen LiDA messages are dismissable by default.
10. Select the Libraries and Locations the system message applies to. If no libraries or locations are selected, the system message will not appear.
    1. When selecting Libraries, this is publishing to the Aspen Discovery catalogs that you want this to show on
    2. When selecting Locations, this is publishing to the Aspen LiDA interfaces that you want this to show on
11. Save your changes.

Display of System Message in Aspen LiDA

The message will show in Aspen LiDA at the top of the screen and be dismissable by default. Note the smaller amount of space on a phone versus a computer when setting up system messages.

Message Style Examples

From top to bottom, in the example photo below, the message styles are:

• Danger (red)
• Success (green)
• Info (blue)
• Warning (yellow)
• none

Note: We don't suggest that you set multiple system messages like this, this is only for example purposes :) 

To set up Menu Links, go to Aspen Administration > Primary Configuration > Library Systems > click into the system you want to update > scroll to the bottom to the Menu Links table.

By default, menu links will show on your Aspen Discovery catalog only. You can choose whether a link appears in both Discovery and LiDA, or in LiDA only.

Menu links that are added to LiDA will show up in the "More" section of the app menu bar at the bottom of the screen.

Note: FontAwesome icons do not carry over to the display in LiDA, only the link text.

When clicked, menu links will open up in a new browser window on the mobile device.

Menu Languages in Other Language(s)

In Aspen Administration > Primary Configuration > Library Systems > click into your settings > scroll down to Menu Links > scroll over to the right and click Edit.

In the Languages section, libraries can decide which translated version of Aspen Discovery and Aspen LiDA that those Menu Links show on.

In Aspen LiDA, Menu Links are fetched on each login. Therefore, for Menu Links in other languges:

If the user already has their language preference selected in Aspen Discovery, then when they login to Aspen LiDA, they will see any of the links with that language preference automatically.

If the user toggles between languages within LiDA, the Menu Links will change on either logging in/logging out and/or closing the app and reloading it. 

To display a scannable barcode in LiDA, you will need to select your library card barcode style in Aspen settings.

1. Head to Primary Configuration > Library Systems > edit the applicable setting. Batch Update can also be used to updated more than one setting at once.
2. In the Search for a Property box, type "barcode"
3. In Library Barcode Style, select the barcode style of your libary card numbers.
4. You do not need to fill in the mix/max barcode length or barcode prefix in order to display scannable barcodes. These settings are unrelated, and are for optionally allowing users to sign in using the unique digits at the end of their card number instead of entering in the entire card number.
5. Save your changes.

Once saved, the library card barcode will display in the user account in Aspen Discovery (Your Library Card), and the Card tab in Aspen LiDA.

As of 24.10, there is a new option to enable a link to your self-registration form within Aspen LiDA in Aspen Administration > Aspen LiDA > General Settings > either Add New or edit the existing setting > "Enable self-registration."

While the setting is there, this functionality is not yet available in LiDA. Self registration links within Aspen LiDA will be available in an upcoming release.

There are two default messages that show when loading Aspen LiDA. They are:

• The oldest library in the world dates from the seventh century BC.
• One of the most overdue library books in the world was returned after 122 years.

These messages can be translated via Aspen Administration > Languages and Translations > Translations

If you are using one of Aspen's event integrations, there is nothing additional you need to do to set up events in LiDA - the functionality will automatically work.

Learn more on Aspen's event integrations.

• See how Events searching works in LiDA
• See how Events display in the patron account
• Customize Event Registration Information Text in LiDA

To manage notifications:

1. Aspen Administration > Aspen LiDA > Notification Settings > Add New
2. Enter a name for the setting.
3. Send In-App Notifications To: by default, notifications are set to None (disabled). Switch to All Users to enable notifications for everyone. Selecting Only Staff Users will enable notifications only for users who have administrative permissions within Aspen. This is primarily to allow staff to see and test notifications before enabling them for all users.
4. Notification Types: Check to enable your desired notifications:
   • Saved Searches - When a new title (added within the last 7 days) is added to a user's saved search, they will receive a notification
   • Custom Alerts - Custom Alerts can be set in Aspen Administration > Aspen LiDA > LiDA Notifications and click Add New.
   • Account Alerts - Alerts related to Linked Accounts (i.e. notifying the linkee if someone has linked to them)
5. ILS Notification Settings: feature postponed
6. Libraries: Check to enable for the desired library system(s).
7. Save your changes.

To begin, go to Aspen Administration > Aspen LiDA > LiDA Notifications and click Add New.

Add a Title. This will be the bolded part of the Notification.

Next, enter the body of the Message. Here you can even add emojis.

Note: the suggested character guidelines under the Message box.

Character limits before being truncated

• iOS: 178 characters (includes both title and message)
• Android (if collapsed, default): 43 characters for message, 39 characters for title
• Android (if expanded): 504 characters for message, 79 characters for title

Sends On - Here you set up the date and time the notice should go out. The time zone is set to the same time as your Aspen server. Aspen will check every 15 minutes for a notice and if it sees one that is past, then it will start the process of sending the notice if it finds one within that window that has not been sent yet.

Expires On - Here you set the length of time before the notice will disappear from a patron's notifications. If left blank, notifications will clear 7 days after the send time.

Exactly when will my notification be sent out?

We have a cron setup to look for notifications to send every 15 minutes. For example, if you create a notification at 1:20pm to go out right away, the cron will pick it up and send off the requests to APNs and FCM (the push notification services: Apple Push Notifications “APNs'' and Firebase Cloud Messaging “FCM”), which then relay to the devices. Please note, that depending on the current server load for push notification services, it might take several minutes to start receiving notifications on devices.

You also have access to a report for notifications that have been sent to APNs and FCM. Every hour, there’s a different cron that’s checking for a receipt from the push notification services to let us know when a notification was successfully received by a device, or not (and why). This report will tell you the date/time that Aspen sent the request to the push notification services, what type of notification (i.e. saved search or custom) it was, the recipient's name, card number, home library, and device model (i.e. Google Pixel 5 or iPhone 12). If a user has notifications setup on multiple devices, they will receive one for each device and will be seen as two separate notifications in the report.

If selecting "An external website" from the "On tap, send user to" dropdown menu, an External URL box will appear. In this text field, specify the URL for your event, list, or other page where the notification should direct your users.

If selecting "A specific screen in the app" from the "On tap, send user to" dropdown menu, a new dropdown menu will appear. This menu shows options for all areas within the Aspen LiDA app to which you can direct users upon tapping the notification -- for example, a specific author or browse category you may be highlighting.

Depending on which one of these in-app options you choose, another box may pop up asking for the specific corresponding term or ID. For example, if selecting Search: Specific term, you would fill in the Search Term keyword for the search to which the user should be directed.

Next, you can specify which Libraries and Locations this notification should go out to. This is helpful if the notice is related to a specific library system or location's program for example.

Another way to target specific groups of users with custom notices is by Patron Types. Aspen will pull in your patron types and you can specify which patron types should receive this notification. For example, a notice you'd want to only go to staff.

At the bottom there is Notification Sent checkbox. This will automatically check after the notice is sent.

Important: If you uncheck this box, the notice will be sent again.

1. Enable Permissions

To access the following Self-Check settings below, make sure you have the following permission(s):

• Administer Aspen LiDA Settings
• Administer Aspen LiDA Self-Check Settings
• Test Self Check (under Circulation)

2. Set Up SIP in ILS and Add Credentials to Aspen

To use the Scan & Go self checkout, you may need a SIP connection set up in your ILS.

Libraries using Koha 23.11 or later and Sierra will NOT need to set up a SIP connection, as LiDA will handle self checkout functionality via API. If this is the case, proceed to step 3.

Once set up in the ILS, you'll need to add these credentials to Aspen in Aspen Administration > Primary Configuration > Account Profiles > edit the setting where the Name field = ils > ILS Connection Configuration > SIP 2 Information (optional).

Fill in the:

• SIP 2 Host
• SIP 2 Port
• SIP 2 User
• SIP 2 Password and Confirm Password

3. Create Self-Check Settings

Go to Aspen Administration > Aspen LiDA > Self-Check Settings > Add New > Give your settings a name > check Enable Self-Check > Check all the Locations that Self-Check is enabled for > Save. 

4. Assign Checkouts To

This is which Location checkouts will be assigned/credited to.

The options are:

• Current Location User is Logged Into
• User Home Location
• Item Location (Koha 23.11+ and Sierra Only)

5. Add Supported Styles of Barcodes that LiDA Can Scan

Click Add New and add the barcode styles that LiDA should be able to scan:

• Aztec
• Codabar
• Code 39
• Code 93
• Code 128
• Data Matrix
• EAN 13
• EAN 8
• ITF-14
• PDF417
• UPC E
• UPC A (Android Only)
• UPC/EAN (Android Only)
• QR

If the barcode is not on the above list, LiDA will not be able to support it.

Instead of adding all options, you might want to add only the item barcodes you know you need to scan for performance and battery optimization.

Scan & Go will not disable RFID tags at this time. The SIP/API connections are purely to allow checkouts via your ILS.

6. Locations

Select Locations that you want to apply these settings to and Save.

For the Location selection, when users login to the community version of Aspen, they are self-selecting one of your branches. If they select a branch location where that is checked, then this functionality will be available to them.

If you have your own branded app, and you have the setting turned on to not make users select a location on the sign in screen, then Aspen would look to the user's Home Library location to see if self-check is enabled.

Sierra libraries will need to follow the directions above as well as Configure a Location Stat Group in Aspen.

Configuring Location Stat Group

1. Navigate to Aspen Administration > Primary Configuration > Locations and select the location you want to configure self check for or batch update multiple locations.
2. Change the ILS/Account Integration > Stat Group to the integer that corresponds to that location’s Stat Group in Sierra and save. The default will be -1.

Configuring Location Circulation Username

1. Navigate to Aspen Administration > Primary Configuration > Locations and select the location you want to configure self check for.
2. Find the Circulation Username under ILS/Account Integration and change it to the username from Sierra that corresponds to that location and save. 

Once you have configured the Location Stat Group and the Circulation Username, you can use the Self Check Tester to test the configuration.

Self-Check Tester

Prerequisites: Before using the test interface, you will need to be sure to setup Aspen to be able to use Self Check following the instructions above. Make sure the Aspen LiDA module is enabled and that your user has permissions to Administer Aspen LiDA Settings and Administer Aspen LiDA Self-Check Settings.

For Check-Outs

1. Navigate to {AspenCatalogURL}/ILS/SelfCheckTester or Aspen Administration > ILS Integration > Test Self Check.
2. Enter the Patron Barcode, Patron PIN/Password, and Item Barcode. Then click Check Out Item. 
3. You will receive a message that indicates whether or not your check-out was successful.

For Check-Ins

Important: Note that check-ins only work for Sierra libraries at this time. Check-outs will work for all ILSs. 

1. Navigate to {AspenCatalogURL}/ILS/SelfCheckTester or Aspen Administration > ILS Integration > Test Self Check.
2. Enter the Patron Barcode, Patron PIN/Password, and Item Barcode. Then click Check In Item. 
3. You will receive a message that indicates whether or not your check-in was successful.

Here is a sample Aspen LiDA testing plan you might want to run through prior to launching the app to the public.

Access the document. Make a copy of the document in order to check the boxes.

If you have any questions or run into any issues, please submit a ticket.

For the most up to date resources on Aspen LiDA, check out our Marketing page.