This article explains how to bulk upload participants in Momenta. You can import users either inside a specific cohort or from the main cohort page (outside a cohort). If your journey includes coaching, this guide also includes extra steps for linking to Coach OS.
Overview
There are two ways to bulk upload participants:
- Inside a cohort – if the cohort already exists and you want to upload users to it
- Outside a cohort – if you want to create cohorts via the Excel template or update users across multiple cohorts
You can also bulk upload users into both Momenta and Coach OS at the same time, as long as all setup steps are completed beforehand.
Uploading to Momenta & Coach Simultaneously
- Ensure the cohort exists in Coach OS and is correctly linked to the corresponding project (same name as Momenta journey).
- Create the cohort in Momenta and toggle Create Coach Users.
- Select the correct Coach cohort and choose a Default Coach.
- In your Excel sheet:
- Fill in the Coach Email (Column E)
- Include the exact Cohort Title (Column F)
- Ensure the sheet name matches the Cohort Journey Code
- Follow the outside-the-cohort upload method below.
- Double-check the Coach cohort afterward to confirm the sync worked.
Bulk Upload Inside a Cohort
- Go to Experiences & Cohorts and open the desired client and experience.
- Click the three dots > Cohorts > open the cohort.
- Click the three dots in the upper right corner > Download Import Template.
- Clear the Excel file (keep headers) and enter participant data:
- Required fields: First Name, Last Name, Email, Role
- Optional: Add temporary passwords for testing
- Ensure the Excel sheet name matches the Cohort Journey Code.
- Click the three dots again > Import Roster > Upload the file.
Bulk Upload Outside a Cohort
- Go to Experiences & Cohorts > select the client and experience.
- Click Download Import Template (top-right).
- Clear the file (keep headers) and fill in user data. Refer to the Descriptions tab.
- Optional: To create a new cohort, enter a Cohort Title in Column F. This will create the cohort during upload.
- Ensure each sheet name = Cohort Journey Code.
- Click Import Roster and upload your completed sheet.
Updating User Information
- Select the cohort(s) and click Export Roster.
- Edit the Excel file to update user info (e.g., team name, email, role).
- Re-upload using Import Roster.
Team Types & Setup
There are two core team types used during uploads:
- Single Team (POD-style): Each user belongs to one team in a cohort.
- Cross Team: A user can be in multiple teams (comma-separated in the Excel).
Additional notes:
- Team names can be reused across cohorts, but are treated as separate entities
- Teams are created automatically during Excel upload
Key Features of Bulk Upload
- Each cohort gets its own Excel sheet when exporting/importing
- Users are unique to a journey, not to a client
- Upload sheets create or update teams automatically
- Sheet names must match cohort codes for successful import
Watchouts & Considerations
- Double-check journey selection: When uploading outside a cohort, verify you're in the correct journey before uploading — new cohorts created in error can only be deleted by the Dev team.
- No duplicate cohort names: Even across journeys, duplicate cohort titles can cause system errors.
- Coach OS dropdown empty? This means the Coach cohort isn’t correctly set up or synced.
- Sheet names matter: Each tab must match the Cohort Journey Code exactly.
Visual Aids
Cohort Settings
Coach OS Sync Settings
Default Coach
Bulk Upload - Inside the Cohort
Go to Experiences & Cohorts -> Identify and click on the three dots, then 'cohorts'
Locate the Cohort and click on the Cohort name
Download the 'Import Template' from within the cohort
Click 'Enable Editing' in the excel
Use the 'Descriptions' tab to help you understand which information goes in what column and whether it's mandatory or not.
In cohort settings, copy the Cohort ID and rename your excel tab with the Cohort ID
Select 'Import Roster'
Select the excel file you just created and click 'Upload'
You should now see all the user you bulk uploaded within the cohort.
Bulk Upload - Outside the Cohort
Go to Experiences & Cohorts -> Identify and click on the three dots, then 'cohorts'
Download the 'Import Template'
Click 'Enable Editing' in the excel and add the cohort name in the 'Cohort Title' column
In cohort settings, copy the Cohort ID and rename your excel tab with the Cohort ID
Click 'Import Roster'
Select the excel file you just created and click 'Upload'
View that the cohort has now been updated with the uploaded participants
Updating User Informating: Using the Bulk Upload
Check the box to select the cohort(s) you wish to update. Then click on 'Export Roster'. Then ammend the excel with the changes and re-upload by clicking 'Import Roster'
Bulk Upload Team Types
Single Teams
Cross Teams
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article