Change Azure DevOps URL

Scott Buchanan 0 Reputation points
2025-06-06T20:52:55.9366667+00:00

I want to change the custom name of our DevOps URL and at the same time, switch to the new domain (https://dev.azure.com/XXX). I am hoping to do thin is one step, but when I change the custom name, the new domain preview is not updated. If I enable the new domain, a confirmation message appears and I am not sure if that is simply a warning or if it is going to commit to changing to the old name. Am I just being chicken and should forge ahead, or does anyone have some tips on this process?

Best,

Scott

image

Azure DevOps
0 comments No comments
{count} votes

2 answers

Sort by: Most helpful
  1. Mubashir Ali 0 Reputation points
    2025-06-07T10:10:03.27+00:00

    Hey Scott Buchanan, totally get where you’re coming from changing your Azure DevOps URL can feel a bit nerve-wracking, especially with the domain switch involved. Here’s the lowdown to help you move forward confidently:

    1. Changing the Custom Name vs. Switching Domain Unfortunately, these two aren’t a single-step process. When you update your custom name (the part before .visualstudio.com), that change doesn’t automatically update the preview for the new domain (https://dev.azure.com/XXX). They’re somewhat independent settings.
    2. What Happens When You Enable the New Domain? The confirmation message you’re seeing is standard. It’s warning you that enabling the new domain is a one-way action once switched, you can’t easily revert to the old .visualstudio.com URL. So yes, it’s not just a warning; it will commit the switch once confirmed.
    3. Recommended Approach
      • First, change your custom organization name and make sure everything works fine on the old domain.
      • Then, when you’re ready and sure, enable the new domain (dev.azure.com/XXX). Accept the confirmation knowing it’s a permanent move.
      • Make sure to notify your team/users about this change because URLs will update.
    4. Backup & Communication Before you commit, backup any critical links, update your documentation, and inform your stakeholders. This reduces surprises and smooths the transition.

    You’re not being chicken it’s smart to be cautious! But the process does require two steps, and the confirmation message means you’re about to finalize the switch. If you’ve tested the new custom name and are ready, go ahead with enabling the new domain.

    Hope this helps! If you want, I can also share official MS docs or a checklist to guide you through.

    0 comments No comments

  2. Durga Reshma Malthi 4,430 Reputation points Microsoft External Staff Moderator
    2025-06-09T09:22:43.98+00:00

    Hi Scott Buchanan

    Changing the custom name and switching to the new domain are not a single-step process. When you update the custom name, it doesn’t automatically update the preview for the new domain.

    Go to Azure DevOps -> Organization Settings -> Overview -> Disable the URL option -> Enter the New name -> Save.

    User's image

    Now the Azure DevOps Organization will be renamed to the new name, and it would reflect in URL. Now enable the option and confirm and save it.

    Hope this helps!

    Please Let me know if you have any queries.

    If you found the information helpful, please click "Upvote" on the post to let us know and consider accepting the answer as the token of appreciation. Thank You.


Your answer

Answers can be marked as Accepted Answers by the question author, which helps users to know the answer solved the author's problem.