Skip to content

Commit 0a94427

Browse files
authored
Merge pull request #9041 from MicrosoftDocs/awp/549015-restrict-org-creation-update
Update restrict-org-creation article per work item 549015
2 parents 01fbd1d + 813551a commit 0a94427

1 file changed

Lines changed: 27 additions & 18 deletions

File tree

Lines changed: 27 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,26 @@
11
---
2-
title: Restrict new organization creation
2+
title: Restrict organization creation
33
titleSuffix: Azure DevOps Services
4-
description: Learn how Azure DevOps Administrators can prevent users from creating new organizations via the Microsoft Entra tenant policy.
4+
description: Restrict who can create Azure DevOps organizations by enabling the Microsoft Entra tenant policy and managing the allowlist.
55
ms.subservice: azure-devops-organizations
66
ms.assetid:
77
ai-usage: ai-assisted
88
ms.topic: how-to
99
ms.author: chcomley
1010
author: chcomley
11-
ms.date: 10/28/2025
11+
ms.date: 03/19/2026
1212
monikerRange: 'azure-devops'
13-
ms.custom: sfi-image-nochange
13+
ms.custom: sfi-image-nochange, awp-ai
1414
---
1515

1616
# Restrict organization creation
1717

1818
[!INCLUDE [version-eq-azure-devops](../../includes/version-eq-azure-devops.md)]
1919

20-
Learn how to turn on the Microsoft Entra tenant policy, which restricts users from creating an organization in Azure DevOps. This policy is turned off, by default.
20+
By default, any user in a Microsoft Entra tenant can create new Azure DevOps organizations. You can enable the **Restrict organization creation** policy to control this behavior. When you turn on this policy, only users and groups on the allowlist can create organizations. All other users, including Azure DevOps administrators, are blocked unless explicitly added to the allowlist.
21+
22+
> [!NOTE]
23+
> This policy only affects the creation of new organizations. It doesn't change access to existing organizations or affect their settings.
2124
2225
## Prerequisites
2326

@@ -27,9 +30,9 @@ Learn how to turn on the Microsoft Entra tenant policy, which restricts users fr
2730

2831
## Turn on the policy
2932

30-
To turn on the policy that restricts users from creating new organizations, do the following steps:
33+
To turn on the policy that restricts users from creating new organizations, follow these steps:
3134

32-
1. Sign in to your organization (```https://dev.azure.com/{Your_Organization}```).
35+
1. Sign in to your organization (`https://dev.azure.com/{Your_Organization}`).
3336

3437
2. Select ![gear icon](../../media/icons/gear-icon.png) **Organization settings**.
3538

@@ -39,32 +42,36 @@ To turn on the policy that restricts users from creating new organizations, do t
3942

4043
:::image type="content" source="media/azure-ad-tenant-policy/restrict-organization-creation-toggle.png" alt-text="Screenshot shows highlighted toggle for Restrict organization creation.":::
4144

42-
## Optional
45+
## Configure the allowlist and error message
4346

44-
After you enable the policy, you can customize its behavior by creating an allowlist for exceptions and customizing the error message users see when they can't create organizations.
47+
After you enable the policy, you can manage which users and groups are allowed to create organizations, and customize the error message that blocked users see.
4548

46-
### Create allowlist
49+
### Add users or groups to the allowlist
4750

4851
> [!WARNING]
4952
> We recommend using groups with your tenant policy allowlist. If you use a named user, a reference to the named user's identity resides in the United States, Europe (EU), and Southeast Asia (Singapore).
5053
51-
When the policy is enabled, only users on the allowlist can create new organizations.
54+
Users or groups on the allowlist can create organizations when you enable the **Restrict organization creation** policy. All other users, including Azure DevOps administrators, are blocked unless they're on this list.
5255

53-
Select **Add Microsoft Entra user or group**.
56+
To add a user or group to the allowlist:
5457

55-
For more information, see [Add organization users and manage access](add-organization-users.md).
58+
1. Go to **Organization settings** > **Microsoft Entra ID**.
59+
2. Under **Allow list**, select **Add Microsoft Entra user or group**.
60+
3. Search for and select the user or group, and then save your changes.
5661

57-
### Create error message
62+
For more information, see [Add organization users and manage access](add-organization-users.md).
5863

59-
To customize the error message, do the following steps:
64+
### Customize the error message
6065

61-
1. In the policy settings in Azure DevOps, select **Edit display message**.
66+
You can change the error message that users see when they're blocked from creating an organization.
6267

63-
2. Enter your customized message, and then select **Save**.
68+
1. Go to **Organization settings** > **Microsoft Entra ID**.
69+
2. Select **Edit display message**.
70+
3. Enter your customized message, and then select **Save**.
6471

6572
![Screenshot shows Customize error message dialog.](media/azure-ad-tenant-policy/display-error-message-dialog.png)
6673

67-
The error message is customized.
74+
The following image shows an example of a customized error message.
6875

6976
![Screenshot shows customized error message.](media/azure-ad-tenant-policy/error-message-example-ui.png)
7077

@@ -74,3 +81,5 @@ The error message is customized.
7481
* [Learn about access with Microsoft Entra ID](access-with-azure-ad.md)
7582
* [Get a list of organizations backed by Microsoft Entra ID](get-list-of-organizations-connected-to-microsoft-entra-id.md)
7683
* [Resolve orphaned organization](resolve-orphaned-organization.md)
84+
* [Manage PAT policies for administrators](manage-pats-with-policies-for-administrators.md)
85+
* [Change application access policies](change-application-access-policies.md)

0 commit comments

Comments
 (0)