How to move a domain on Netlify

The challenge is that this specific use case isn’t covered in Netlify’s official documentation. However, it has been discussed multiple times in the support forums. Here’s a step-by-step guide to transfer the domain from the old site to the new one:

Steps to Move the Domain

1. Go to the Domain Management section in the settings of the old site.
2. Open the Options dropdown for the domain and select Remove domain.
3. Navigate to the Domain Management section in the settings of the new site.
4. Click Add domain and re-add the domain you just removed from the old site.

That’s it—you’re done!

Things to Keep in Mind

Prerequisites: These steps assume that your DNS records are managed on Netlify and that both the old and new sites belong to the same Netlify “Team”. If this isn’t the case, additional steps may be required (I haven’t tested those scenarios).

Propagation Time: The changes won’t take effect immediately. It may take some time before your domain points to the new site. In my experience, this process took about 2–3 hours.

UI Inconsistencies: There’s a known UI quirk in the DNS settings. Even after you move the domain to the new codebase, the DNS records may still appear as though they’re pointing to the old codebase. Renaming your old site doesn’t help; the DNS records will update to reflect the new name of the old site instead! Don’t let this old bug (noted as far back as 2019) mislead you—the domain settings should work regardless.