You can update multiple users by preparing an Excel or .CSV file that includes a unique identifier (Email Address or ID Number) and the fields you want to change, then importing the file in People.

Permission Level Required: Owner | District Manager| Manager

How to Use Bulk User Updates in People: You will build a spreadsheet that only includes the columns you want to update.
Fields Available to Update: What fields you can and cannot manually update.
How to Import Your File into Minga: See step-by-step how to upload your file.
Troubleshooting
FAQ
Resources

How to Use Bulk User Updates in People

You can update user fields in bulk by importing an Excel or .CSV file through People Manager using the same workflow used for adding multiple users.

Step-by-step Guide to Creating Your Update File

Export or build your update spreadsheet.
○ Create an Excel file or .CSV file that contains one row per user you want to update.
○ Include only the columns for the fields you want to change, since columns not included will not be updated.
Add a unique identifier for each user.
○ Include Email Address or ID Number for every row so Minga can match updates to the correct existing user.
○ Use ID Number when you want to update student records using a Student ID from your SIS.

Important: You cannot update Email Address using a list upload, even though Email Address can be used to match an existing user.

Example: Update all Student Grades for a New School Year

You can update grades for an entire student list by uploading a file that includes ID Number and Grade (and any other fields you want to refresh).

Download your current student list from your SIS
○ Use a SIS export that contains ID Number and current-year Grade.
Keep only the columns you need to change
○ Include ID Number and Grade if grades are the only change.
○ Include additional columns if you want to refresh more fields during the same upload.

Tip: A “full refresh” export from your SIS is a fast way to update grades and personal information at the same time, as long as every row includes ID Number.

Fields Available to Update

You can update the following user fields through a list upload, as long as your spreadsheet includes a unique identifier column.

Field	What it updates	Notes
First Name	Updates the user’s first name.
Last Name	Updates the user’s last name.
Email Address (Unique Identifier)	Identifies an existing user for updates.	Email Address cannot be updated via list upload.
ID Number (Unique Identifier)	Identifies an existing user for updates.	This is the Student ID shown on the user profile.
Display Name	Updates the name shown in Minga.	This defaults to first and last name for Student and Parent roles. This defaults to first initial and last name for Owner, Manager, and Teacher roles.
Role	Updates the user’s role.	A great option to update users from Teacher to Manager, or Staff to Teacher
Phone Number	Updates the user’s phone number.
Grade	Updates the user’s grade level.	Grade should be numeric only.
Custom ID Field 1	Updates a custom ID value on student IDs.	A custom identification you want to appear on a Student's ID
Custom ID Field 2	Updates a custom ID value on student IDs.	A custom identification you want to appear on a Student's ID
Birth date	Updates the user’s birthdate.	If their birthdate is added, the member will be included in birthday greetings in your Minga on their birthday

How to Import Your File into Minga

Step-by-step Guide to Importing your Update File

Open the People Dashboard.
○ On web, People Dashboard appears on the right side of the desktop experience.
Click Import List.
○ In the top right corner, you will see the button Import list next to Add person.
○ This opens the file upload and mapping workflow.
Drag and drop or click on the file icon to select your file to upload.
○ Drag your file directly onto the icon from your desktop
○ Or click on the file icon to search for the file on your device
Select the role you are updating from the Default role (required) dropdown.
○ If not selected, this will automatically default to Student.
Select Update fields if they already exist in What to do with people that already exist dropdown menu.
○ This setting applies spreadsheet values to users matched by Email Address or ID Number.
If your file contains headers, select First Row Contains Headers.
○ This prevents errors in uploading, as Minga will try to match the data in the headers to users in Minga.
Select the correct headers to correspond with the data listed in the column below.
○ Match every spreadsheet column to the intended Minga field.
○ Mark any column you do not want to update as ignored.
Select Archive Existing Users Not On List if you want to archive users not included
○ This archives any students, student leaders, or teachers who do not appear in the uploaded list.
○ Archiving is a PERMANENT action and cannot be reversed, so ensure you are removing users who will no longer need to access Minga.
Click Import to run the update.
○ Review the import result screen after processing completes.

Important: Archive Existing Users Not On List should only be used when your upload file represents the complete set of active users for that group, since anyone missing from the file will be archived.

Troubleshooting

Issue: The import shows errors in the upload summary.
Solution: You can open the error report by clicking Download next to ERRORS in the Upload Summary, then correcting the spreadsheet and re-importing it.

Issue: The error report says “Creating a new user requires an email address.”
Solution: You can fix this by correcting the unique identifier so Minga recognizes the row as an existing user.

Open the downloaded ERRORS spreadsheet.
○ Locate the row flagged with the email-address error and add a valid email address.
Verify the ID Number or Email Address matches the existing user exactly.
○ A typo in ID Number can cause Minga to treat the row as a new user.
Correct the value and re-upload the file using Import List.
○ Keep Update fields if they already exist selected.

Issue: A column updated data you did not intend to change.
Solution: You can prevent accidental changes by removing that column from your spreadsheet or setting that column to “ignore” during header mapping.

FAQs

Can I update users with a spreadsheet without changing every field?

Yes! You can update users with a spreadsheet without changing every field by including only the columns you want to update and leaving out all other columns.

What identifier do I need to include to update existing users?

You can update existing users by including a unique identifier like Email Address or ID Number, for each user, so Minga can match each row to the correct user record.

Can I update email addresses through a list upload?

No, you cannot update email addresses through a list upload, even though Email Address can be used as the identifier for matching an existing user.

How do I archive students or teachers who left the school during an update?

You can archive users who left by enabling Archive Existing Users Not On List during Import List when your upload file includes your complete active user list.