Assign usernames for use in the portal
By default, most portals use email addresses as a unique identifier to log in to LearnUpon. However, you can assign users a username as login in addition to their email.
Availability: all customers
Setting up your portal with either email addresses or usernames is a business decision you discuss with your Implementation Consultant (IC) or Customer Success Manager (CSM) to ensure that it is an appropriate solution for your business.
Reasons for choosing usernames instead of email addresses may include:
- you're integrating LearnUpon with another system which uses usernames instead of email
- you have Single Sign On (SSO) set up with an existing system using usernames instead of email
- your learners do not use email as part of your business processes
Set up a portal with usernames: overview
You can set up the portal for usernames during implementation, or you can change your portal from email addresses to usernames as unique identifiers.
To make this change, you need to prepare your existing users' login data to add usernames to their profiles.
When you're ready, contact the Support team to switch on usernames for the portal.
Username criteria
By default, the minimum length of usernames is 6 characters. LearnUpon can adjust the length down to 3 characters on request. Discuss this option with your Implementation Consultant or Customer Success Manager.
Usernames can include all alphanumeric characters and a limited set of additional characters:
- hyphen or dash: -
- underscore: _
- dot or period: .
- comma: ,
- at sign: @
- dollar sign: $
- hashtag: #
Considerations about username portals
In a username portal, users without email addresses in their profiles do not receive automated notifications from LearnUpon. These notifications can include:
- portal invitations
- enrollment reminders
- course completion confirmations
- reset password emails
For example, you must distribute account passwords to users manually, outside the portal.
Upload new accounts with usernames
For username portals that have never used email addresses, you can use batch user upload to create your user accounts.
- From main navigation go to Users > Actions > Batch Upload.
- From Select your user data file, select download an example file to download a CSV template for user data.
- Open the template and add a
usernamecolumn. - Enter your users' data in the template as required, including their usernames.
- Use this CSV file to create new accounts.
Follow the instructions for creating new users as required. Upload users by batch CSV file
Change the portal from email to usernames
Before LearnUpon Support can turn on usernames on your portal, you must first update all of the existing users with a username.
When your learners all have usernames as well as email addresses, Support can change your portal identifiers.
You can add usernames to the existing users on your portal by the following methods:
- API, using the user update endpoints
- request an update from the Support team
See:
Note: you cannot use batch user upload to update existing accounts that use email as unique identifiers.
Prepare your current users' account data
For changing usernames with help from the Support team, you need to provide Support with a CSV file that contains both old and new unique identifiers.
The CSV file should contain only the required columns of email, new_username and optionally, new_email. Delete the rest of the columns and template contents.
See: