Microsoft Entra ID
GeneralBulk delete users in Microsoft Entra ID
In brief
The instructions now require the exact downloaded column header and allow each user row to contain either a user principal name or object ID. The examples row may remain, and User Administrator is listed as the minimum role.
What Entra admins need to know
Review bulk-delete templates and automation to preserve the exact header, use a supported identifier, and ensure the operator has at least the User Administrator role.
This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.
Documentation change
View on Microsoft LearnThe comparison below shows only the changed extract. Use the full-page view for complete context.
Bulk delete users in Microsoft Entra ID
Overview
Using the admin center in Microsoft Entra ID, part of Microsoft Entra, you can remove a large number of users by using a comma-separated values (CSV) file to bulk delete users.
Prerequisites
To bulk delete users in the Microsoft Entra admin center, sign in as at least a User Administrator.
Bulk delete users
Sign in to the Microsoft Entra admin center
Sign in to the Microsoft Entra admin center as at least a User Administrator.
Select Microsoft Entra ID. :::image type="content" source="./media/users-bulk-delete/users-bulk-delete.png" alt-text="Screenshot of the Users page with the Bulk delete option selected.":::
On the Bulk delete user page, select Download to download the latest version of the CSV template.
Open the CSV
filefile, preserve the column header exactly as downloaded, and add a line for each user you want to delete.The only required value isFor each user, enter either the User principal name or Object ID. Save the file.On the Bulk delete user page, under Upload your csv file, browse to the file. When you select the file and select Submit, validation of the CSV file starts.
When the file contents are validated, you’ll see File uploaded successfully. If there are errors, you must fix them before you can submit the job.
When your file passes validation, select Submit to start the bulk operation that deletes the users.
The rows in the example downloaded CSV template below are as follows:
Version number: The first row containing the version number (for example,version:v1.0) must be included in the upload CSV. If your downloaded template includes this row, don't remove or modify it.- Column headings: Preserve
User name [userPrincipalName]UserPrincipalName or Object ID [UPN or objectId] Required. Older versions of the template might vary.exactly as downloaded. - Examples row:
The template might includeYou can keep the examples row in the CSV file. Add the users that you want to delete on the following rows. For each user, enter arow of example values.Example: [email protected]You must remove the example row and replace it with your own entries.user principal name (UPN) or object ID.
:::image type="content" source="./media/users-bulk-delete/delete-csv-file.png" alt-text="Screenshot of a bulk delete CSV template with the CSV file contains names and IDs of the users to delete.required UserPrincipalName or Object ID column.":::
[!INCLUDE bulk-operations-csv-template-note]
Example CSV file
Here's an example of a completed CSV file ready for upload:
version:v1.0
User name [userPrincipalName]UserPrincipalName or Object ID [UPN or objectId] Required
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]00aa00aa-bb11-cc22-dd33-44ee44ee44ee
Additional guidance for the CSV template
[!INCLUDE Bulk operations limitations]
Next stepsRelated content
@@ -1,24 +1,26 @@ --- title: Bulk delete users in Microsoft Entra ID description: Delete users in bulk in Microsoft Entra ID-ms.date: 03/05/2026+author: tafra00+ms.author: tazkiaafra+ms.service: entra-id+ms.date: 09/25/2026 ms.topic: how-to-ms.custom: it-pro, sfi-image-nochange-ms.reviewer: jeffsta+ai-usage: ai-assisted+ms.custom: it-pro, sfi-image-nochange, msecd-doc-authoring-1026++#customer intent: As a user administrator, I want to delete users in bulk so that I can remove multiple users from Microsoft Entra ID at once. --- # Bulk delete users in Microsoft Entra ID --## Overview- Using the admin center in Microsoft Entra ID, part of Microsoft Entra, you can remove a large number of users by using a comma-separated values (CSV) file to bulk delete users. -## To bulk delete users+## Prerequisites -> [!IMPORTANT]-> Updates are being made to bulk operations. While this issue is being addressed, you might experience problems deleting users assigned to privileged roles. This problem is temporary and is being resolved as soon as possible.+To bulk delete users in the Microsoft Entra admin center, sign in as at least a User Administrator. +## Bulk delete users 1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [User Administrator](~/identity/role-based-access-control/permissions-reference.md#user-administrator). 1. Select **Microsoft Entra ID**.@@ -27,7 +29,7 @@ Using the admin center in Microsoft Entra ID, part of Microsoft Entra, you can r :::image type="content" source="./media/users-bulk-delete/users-bulk-delete.png" alt-text="Screenshot of the Users page with the Bulk delete option selected."::: 1. On the **Bulk delete user** page, select **Download** to download the latest version of the CSV template.-1. Open the CSV file and add a line for each user you want to delete. The only required value is **User principal name**. Save the file.+1. Open the CSV file, preserve the column header exactly as downloaded, and add a line for each user you want to delete. For each user, enter either the **User principal name** or **Object ID**. Save the file. 1. On the **Bulk delete user** page, under **Upload your csv file**, browse to the file. When you select the file and select **Submit**, validation of the CSV file starts. 1. When the file contents are validated, you’ll see **File uploaded successfully**. If there are errors, you must fix them before you can submit the job. 1. When your file passes validation, select **Submit** to start the bulk operation that deletes the users.@@ -41,25 +43,20 @@ For more information about bulk operations limitations, see [Bulk delete service The rows in the example downloaded CSV template below are as follows: -- **Version number**: The first row containing the version number (for example, `version:v1.0`) must be included in the upload CSV. If your downloaded template includes this row, don't remove or modify it.-- **Column headings**: `User name [userPrincipalName] Required`. Older versions of the template might vary.-- **Examples row**: The template might include a row of example values. `Example: [email protected]` You must remove the example row and replace it with your own entries.--:::image type="content" source="./media/users-bulk-delete/delete-csv-file.png" alt-text="Screenshot of the CSV file contains names and IDs of the users to delete.":::+- **Column headings**: Preserve `UserPrincipalName or Object ID [UPN or objectId] Required` exactly as downloaded.+- **Examples row**: You can keep the examples row in the CSV file. Add the users that you want to delete on the following rows. For each user, enter a user principal name (UPN) or object ID. -[!INCLUDE [bulk-operations-csv-template-note](~/includes/bulk-operations-csv-template-note.md)]+:::image type="content" source="./media/users-bulk-delete/delete-csv-file.png" alt-text="Screenshot of a bulk delete CSV template with the required UserPrincipalName or Object ID column."::: ### Example CSV file Here's an example of a completed CSV file ready for upload: ```csv-version:v1.0-User name [userPrincipalName] Required+UserPrincipalName or Object ID [UPN or objectId] Required[email protected] [email protected][email protected][email protected][email protected]+00aa00aa-bb11-cc22-dd33-44ee44ee44ee ``` ### Additional guidance for the CSV template@@ -96,7 +93,7 @@ Verify that the users that you deleted are no longer listed. [!INCLUDE [Bulk operations limitations](~/includes/bulk-operations-limitations.md)] -## Next steps+## Related content - [Bulk add users](users-bulk-add.md) - [Download list of users](users-bulk-download.md)