Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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. The URLs of projects, repositories, and other resources within the organization change when you enable the new organization URL. After the rename, complete the applicable required updates.
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
Sign in to your organization (
https://dev.azure.com/{yourorganization}).Select
Organization settings.
Select Overview, enter a new name for the organization, and then select Save. Move the toggle if you want to use the new URL.
Important
Follow these guidelines when you create your 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
- Keep your organization name under 50 Unicode characters
- End with a letter or number
If you use any disallowed characters, the following error message displays: VS850015: The specified name is not allowed to be used: {Organization name}.
Confirm that you want to rename your organization and save your changes.
Your organization is renamed.
Update references after the rename
When you enable the new organization URL, notify your users and update references that contain the previous organization name. Complete the following actions as applicable:
Bookmarks and links: Update saved links to projects, repositories, work items, pipelines, and other resources.
Client connections: Reconnect clients such as Visual Studio and Azure DevOps Office Integration to the new organization URL.
Git remotes: Update the remote URL in each local repository. For more information, see Update the Git remotes on your dev machines.
TFVC workspaces: Update the cached organization URL by running the following command for each affected workspace. For more information, see Workspaces command.
tf workspaces /collection:https://dev.azure.com/{neworganization}Self-hosted agents: Remove and reconfigure agents that you registered with the previous organization URL. For more information, see Remove and reconfigure a Windows agent, Linux agent, or macOS agent.
Analytics and Power BI: Update OData feed URLs and other data source URLs that contain the previous organization name. For the OData URL format, see Connect with Power BI Data Connector.
Tools and integrations: Update hardcoded organization URLs in scripts, REST API clients, extensions, pipeline variables, webhooks, and other external integrations. Then, test each integration with the new URL.
Workload identity federation: Check Azure Resource Manager service connections that use a name-based subject in the format
sc://<organization-name>/<project-name>/<service-connection-name>. If the subject contains the previous organization name, update the federated credential. ID-based subjects don't require an update. For more information, see Check the issuer URL for accuracy.
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.