Email Matching Requirements

Email Matching Requirements

Email Matching Requirements


Overview

For Pluralsight progress to sync correctly to Learn Amp, learners must have identical email addresses on both platforms. This guide explains why email matching matters, how to verify alignment, and what to do when emails don't match.

Getting this right before rolling out Pluralsight content ensures your learners' progress is tracked accurately from day one.


Functionality Breakdown

Why Email Matching Matters

When Learn Amp syncs progress from Pluralsight, it uses email addresses to identify which learner completed which course. The process works like this:

  1. Pluralsight reports: "user@example.com completed Course X"

  2. Learn Amp searches for a user with email "user@example.com"

  3. If found, the completion is recorded against that user's profile

  4. If not found, the completion cannot be attributed and is skipped

Matching Rules

Learn Amp Email

Pluralsight Email

Result

💡 Tip: Email matching is case-insensitive, so capitalisation differences won't cause issues.


Prerequisites

Role Requirements

To audit and manage user emails, you need one of these Learn Amp roles:

  • HR

  • Admin

  • Owner

To manage Pluralsight user accounts, you need:

  • Pluralsight Administrator access


Quick Start Guide

Step 1: Export Your Learn Amp User List

  1. Navigate to ManageIndividuals from the sidebar

  2. Click Export to download your user list

  3. Open the CSV file – note the email column

Step 2: Export Your Pluralsight User List

  1. Log in to your Pluralsight admin portal

  2. Navigate to your user management section

  3. Export your user list with email addresses

  4. Open the CSV file for comparison

Step 3: Compare Email Lists

Using a spreadsheet tool:

  1. Create a comparison of both email lists

  2. Use VLOOKUP or similar to identify mismatches

  3. Flag users whose emails differ between platforms

Quick formula example (Excel/Google Sheets):

=IF(ISNA(VLOOKUP(A2, PluralsightEmails, 1, FALSE)), "MISMATCH", "OK")

Step 4: Resolve Mismatches

For each mismatched user, decide whether to:

Option A: Update the Learn Amp email

  1. Navigate to the user's profile in Learn Amp

  2. Edit their email to match Pluralsight

  3. Save changes

Option B: Update the Pluralsight email

  1. Log in to Pluralsight admin

  2. Update the user's email to match Learn Amp

  3. Save changes

Option C: Accept the mismatch

  • If the user won't use Pluralsight, no action needed

  • Document the decision for future reference

⚠️ Warning: Changing email addresses may affect the user's ability to log in via SSO. Coordinate with your IT team before making bulk changes.


Best Practices

Before Rollout

  1. Audit emails proactively: Don't wait until learners report missing progress

  2. Establish a single source of truth: Decide which system's email format takes precedence

  3. Communicate with learners: Let them know to use their work email when accessing Pluralsight

Ongoing Management

  1. Include in onboarding: Ensure new starters are set up correctly on both platforms

  2. Periodic audits: Run quarterly comparisons to catch drift

  3. Document exceptions: Track any users with known mismatches and why

For Organisations Using SSO

If you use Single Sign-On:

  • Email addresses are typically consistent as they're managed centrally

  • Ensure your identity provider syncs the same email to both platforms

  • Check that email format settings match (e.g., firstname.lastname vs firstnamelastname)


FAQs

What happens to historical progress if I fix a mismatched email?
Future progress will sync correctly, but historical completions won't be retroactively imported. The learner would need to access the course again for Learn Amp to pick up the completion.

Can I use a secondary email field for matching?
No. Learn Amp matches on the primary email address only. If learners have multiple emails, ensure the primary email matches across platforms.

How quickly do email changes take effect?
Changes in Learn Amp take effect immediately. The next Pluralsight sync will use the updated email for matching.

What if a learner has personal and work Pluralsight accounts?
They should use their work account (matching their Learn Amp email) for any work-related learning. Personal account activity won't sync.

Can admins see which users have mismatched emails?
Not directly in Learn Amp. You'll need to run the comparison process described above to identify mismatches.


Troubleshooting

Issue

Solution

Issue

Solution

User's progress isn't syncing

First, verify their email matches exactly between platforms. Check for subtle differences like extra spaces or different domains.

Email looks identical but still not syncing

Check for hidden characters or encoding issues. Try retyping the email manually in both systems.

Can't change email in Learn Amp

The email field may be locked if managed by SSO or SCIM. Contact your IT team to update it at the identity provider level.

Bulk email update needed

Export your user list, make changes in the CSV, and use Learn Amp's bulk import feature to update emails. Test with a small group first.

New joiner's progress not tracking

Ensure their Pluralsight account was created with their work email before they started any courses.