Configure and Upload .CSV Files
Configure a CSV file for Security Journey user uploads, including supported fields, admin access, archiving, and formatting requirements.
What You Can Do with a CSV Upload
Using a CSV file, you can:
-
Add new learners
-
Update existing learners
- Promote administrators
All actions can be completed in a single upload.
Supported Learner Attributes
Your CSV file can include the following fields:
-
Email
-
First Name
-
Last Name
-
Business Unit
-
Company
-
Country
-
Department
-
Employee Number
-
Job Role
-
Manager’s Email Address
-
Manager’s Name
-
Security Champion
-
Title
-
Team
Field Requirements and Notes
-
Country
Must use a valid ISO 3166-2 two-character country code (for example, US, CA, GB). Uploads will fail if the value is invalid. -
Security Champion
Must be set to TRUE or FALSE.
Add or Remove Admin Access via CSV
You can manage admin access directly in your CSV file.
-
Add a column named Admin.
-
Set the value to:
-
TRUE to grant admin access
-
FALSE to remove admin access
-
Archive Users via CSV
You can archive users as part of the upload process.
-
Add a column named Archive.
-
Set the value to TRUE to archive the user.
Upload Your CSV File
-
Navigate to Users in the SecurityJourney platform.
-
Click Add Users.
-
Select your prepared CSV file from your computer.
-
Click Add Users to complete the upload.
Download the CSV Template (Optional)
If you need help formatting your file:
-
Go to Admin > Add Users.
-
Download the CSV template from the top of the Add Users modal.
-
Use the template to ensure correct column names and formatting.
Tips for a Successful Upload
-
Ensure column headers exactly match the supported learner attributes.
-
Use consistent formatting for all rows.
-
Verify boolean fields use TRUE or FALSE (not Yes/No or 1/0).
-
Confirm country values use valid ISO 3166-2 codes.
-
If the upload fails, review the CSV for formatting or data errors and try again.