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:
Pluralsight reports: "user@example.com completed Course X"
Learn Amp searches for a user with email "user@example.com"
If found, the completion is recorded against that user's profile
If not found, the completion cannot be attributed and is skipped
Matching Rules
Learn Amp Email | Pluralsight Email | Result |
|---|---|---|
✅ Syncs correctly | ||
❌ Won't sync | ||
✅ Syncs (case-insensitive) | ||
❌ Won't sync |
💡 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
Navigate to Manage → Individuals from the sidebar
Click Export to download your user list
Open the CSV file – note the email column
Step 2: Export Your Pluralsight User List
Log in to your Pluralsight admin portal
Navigate to your user management section
Export your user list with email addresses
Open the CSV file for comparison
Step 3: Compare Email Lists
Using a spreadsheet tool:
Create a comparison of both email lists
Use VLOOKUP or similar to identify mismatches
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
Navigate to the user's profile in Learn Amp
Edit their email to match Pluralsight
Save changes
Option B: Update the Pluralsight email
Log in to Pluralsight admin
Update the user's email to match Learn Amp
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
Audit emails proactively: Don't wait until learners report missing progress
Establish a single source of truth: Decide which system's email format takes precedence
Communicate with learners: Let them know to use their work email when accessing Pluralsight
Ongoing Management
Include in onboarding: Ensure new starters are set up correctly on both platforms
Periodic audits: Run quarterly comparisons to catch drift
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 |
|---|---|
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. |