Skip to main content

Step 5 - User set-up

Add your users to Tribal Habits in bulk via CSV upload, one by one, through an integration or with self-registration. Give admin and creator access, and get tips for preparing your CSV and when to send invitations.

Written by Lou Monsour

Overview

In this step, you’ll add your users to your portal. Adding users is a significant step, so read this article fully before you start.

This is step 5 in the implementation process. After this step, you’ll move on to Step 6 – Curriculum Planning.

Note: If you’re creating training to sell to customers, you may not have users to add yet. Return to this step when your first group of learners is ready.

How to complete this step

  1. Choose how to add your users. You can use one or more of these options:

    • Bulk upload: Upload users in bulk using a CSV file. This is usually best for your first group of users.

    • One by one: Add users one by one. This works well for small numbers of users or new starters.

    • HR integration: If you’re setting up an HR integration, your users may be added automatically. We’ll discuss this with you as part of setting up your integration. Learn more about managed integrations.

    • SSO auto-provisioning: If you use SSO and allow auto-provisioning, users are created the first time they log in with SSO. You may still want to add users in advance, so you can enrol them in training and fill in their custom fields before they log in.

    • Self-registration: If you’re training people outside your organisation, such as contractors, volunteers or customers, you can let them register themselves using a token. You’ll create tokens once your training is ready.

    • LMS Link (add-on): If you share topics with an external LMS using LMS Link, users are created automatically when they open a topic from that LMS.

  2. Prepare your CSV (bulk upload only). Download the CSV template from your portal and fill in your users’ details, including any custom fields you set up in step 4 and creator access for any users who will build training.

  3. Add your users. Upload your CSV, or add each user one by one. Don’t send invitation emails yet, unless you want users to have access to the portal before they’re enrolled in training. You’ll send invitations in step 12.

  4. Check your users. Review a few user profiles to make sure their details, including custom fields, have been added correctly.

  5. Give admin access (if needed). If any of your admins were added in this step, a Super Admin can now give them admin access. Admin access is given one user at a time. See Step 2 - Admins and key contacts for more on admin access levels.

  6. Give creator access (if needed). If users who aren’t admins will build training, give them creator access. You can do this when adding users, either one by one or in your CSV, or afterwards in their profile’s permissions panel.

Best practices

  • Check your CSV carefully before uploading: Uploads are strict, so a small error can stop a row or the whole file from processing. Review common CSV problems if your upload doesn’t work.

  • Choose the right user type: Every user has a Type, such as Staff, Contractor, Volunteer or Customer. Type doesn’t affect what users can do, but you can use it to filter reports, set up automated enrolments and control which training appears in the catalogue. If no type is set, users are created as Staff.

  • Plan how your users will log in: Users can log in with a username and password, through SSO, or by other methods. If you set up SSO in step 1, use the LOGIN field to set which users log in with SSO and which use a username and password. Learn more about the different ways users can log in.

  • Don’t add parent portal admins to child portals: If you have multiple portals, admins from your parent portal can log in to child portals with their existing details. You don’t need to add them as users in each child portal.

  • Use self-registration for external learners only: Self-registered users are always created as external users, so they log in with an email and password rather than SSO. To enrol internal users with a link, use an internal enrolment link instead.

  • Hold off on invitation emails: Sending invitations before your training and internal communication are ready can confuse users. Unless you want users to access the portal early, wait until you’re ready to launch.

  • Plan for new starters: Decide how you’ll add new users after your first upload, such as adding them one by one, with regular CSV uploads or through your integration.

Examples

  • Small organisation: This organisation downloads the CSV template, fills in their users’ details, including their Department, Role and Start date, and uploads it. They give creator access to a few subject matter experts. About one new starter joins each month, so their admin adds new starters one by one.

  • Medium organisation: This organisation uploads their users with a CSV, including their Location, Division and Team. Their two Standard Admins were included in the upload, so their Super Admin gives them admin access. They also give creator access to two staff members who aren’t admins. Their People Admin adds new starters each week.

  • Large organisation: This organisation’s staff are added automatically through their HR integration. Their contractors aren’t in their HR system, so they plan to use self-registration once their contractor induction is ready. They give creator access to six staff members who aren’t admins.

Next step
Continue to Step 6 - Curriculum planning.

Did this answer your question?