Edit

Share via

Rename your organization in Azure DevOps

  • Article

Azure DevOps Services

You can change your organization name (URL) at any time in Azure DevOps. This action allows you to update the URL to better reflect your organization's branding or structure. Changing the organization name updates the URL used to access your Azure DevOps resources, including the URLs of your projects, repositories and other resources in the organization. Follow the steps in this article to rename your organization and ensure a smooth transition for your team.

Caution

The rename operation affects your organization's connections and individuals who are currently working with your organization. Before you start, meet the prerequisites and find out what to do after renaming your organization. The URL of projects, repositories, and other resources within the organization will change. Make sure to update any bookmarks or links to these resources.

Prerequisites

Category Requirements
Permissions Organization owner.
Access levels At least Basic access.
Tasks - Save your work.
- Ensure other members aren't using the service.

Note

Wait at least one hour after the most recent rename operation before renaming an organization again.

Rename your organization

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select Organization settings.

    Screenshot showing a gear icon and Organization settings emphasized.

  3. Select Overview, enter a new name for the organization, and then select Save. Move the toggle if you want to use the new URL.

    Screenshot showing the Organization tab, Name entry, and Save button all emphasized.

    Important

    Adhere to the following guidelines when you create an organization name.

    • Use only letters from the English alphabet
    • Start your organization name with a letter or number
    • Use letters, numbers, or hyphens after the initial character
    • Ensure that your organization doesn't exceed 50 Unicode characters
    • End with a letter or number

    If you use any of the disallowed characters, you get the following error message: VS850015: The specified name is not allowed to be used: {Organization name}.

  4. Confirm that you want to rename your organization and save your changes.

    Screenshot showing confirmation screen for organization rename.

Your organization is renamed.

Frequently asked questions (FAQs)

Q: If I change the organization URL, can I switch back?

A: The organization URL setting is two-way toggle. You can turn on the new domain name URL. You can also turn off the new URL - then, you go back to using old URL format.