How to bulk update Microsoft 365 users
-
Click Tools > Users, then Bulk update in the toolbar.
-
Click Download template to get a CSV with the most common columns.
-
Edit the CSV. Keep the userPrincipalName column (this matches each row to an existing account) and add a column for each property you want to change. Fill in only the users and cells you want to update, then save.
Only the columns you include are changed, every other property on the account is left as it is. A blank cell also leaves that property unchanged.
-
Click Choose CSV and select your file.
-
Review the Preview. Rows are matched on userPrincipalName, and any column the app doesn't recognize is listed as ignored. See the full list of columns you can change in the table below.
-
Click Apply updates to N users. Each row updates to Updated, or shows the reason it failed, as it finishes.
A row fails if its userPrincipalName does not match an existing account, or if the change is rejected (for example a value that breaks a tenant policy).
Supported columns
Column headers are matched without case sensitivity, and the aliases below are accepted too. Any column not listed here is ignored. Only userPrincipalName is required, it is the key that matches each row to an account.
| Column | Aliases & notes | Required |
|---|---|---|
| userPrincipalName | upn, userid, matches the row to an existing account, for example jsmith@contoso.com | Yes |
| displayName | No | |
| givenName | firstName | No |
| surname | lastName | No |
| jobTitle | title | No |
| department | No | |
| companyName | company | No |
| officeLocation | office | No |
| mobilePhone | mobile | No |
| businessPhone | phone, telephoneNumber | No |
| streetAddress | street | No |
| city | No | |
| state | No | |
| postalCode | zip | No |
| country | No | |
| usageLocation | Two-letter country code, for example US | No |
| employeeId | No | |
| employeeType | No |

