Switching DNS From One Pantheon Site to Another
Learn how to change DNS details between Pantheon Drupal or WordPress sites.
There are times when you may want to switch a domain's DNS from one Pantheon site to another. The same domain cannot be added to more than one environment at the same time, but it's possible to point a domain to another site with minimal impact to visitors.
Only the Site Owner, or if the site is owned by an Organization - the Organization's Administrators, can change the Site's Plan. If you are not the owner, you will not see the options discussed below.
Prepare The New Site
For information on preparing your site for launch, please review our Launch Essentials.
wp-config.php and comment out any hardcoded redirect logic for Pantheon's Platform domains (e.g.
live-mysite.pantheon.io). Once DNS has been configured, you can update the redirects to use the default Platform domain (e.g.
live-mysite.pantheonsite.io) if needed.
Select a site plan
- Go to the Site Dashboard of your New Site.
- Navigate to Settings > Billing
- Select existing credit card on file or add a new credit card.
- To select a paid plan, navigate to Plan, select a paid plan and click Update Plan.
HTTPS on the New Site
HTTPS can take up to an hour to provision after you switch DNS to the new site, so you may want to plan a maintenance window accordingly.
Determine the New DNS Records
Because the same domain cannot be added to more than one environment, you can use temporary domain names to determine the DNS records. Temporarily add something like
www.example-new.com to the new site's Live environment to see the required DNS records.
Alternately, you can use tools like
nslookup to find the IP addresses for your new environment:
Go to the new site's Live environment and get the Platform domain. (e.g.
From your command line (in any operating system), run
nslookupon the platform domain:
The output IP should look like this:
Prepare your DNS Settings
Lower the Time to Live (TTL)
The TTL dictates the lifespan of a DNS record - a shorter time means less time to wait until the changes go into effect. TTLs are always set in seconds. When you make a change to the TTL you need to wait for the old TTL time to pass. So, for example, if the TTL had been set to 86400, you would need to wait a full 24 hours for the new setting to be in place everywhere. You can lower your TTL well in advance of actually switching the DNS values to point to the new site, so the time to see your DNS change will be much quicker than othwersise.
- Log in to the DNS host for your domain and lower the TTL of the bare domain and www records as much as possible. If possible, set the TTL to 60 or 120 seconds for more efficient propagation.
Switch the Domains
To minimize a disruption, open the Dashboard for both the currently launched site and the new site in different browser tabs so you can quickly make the changes.
Remove the Domain(s) from the Launched Site
- From one browser tab, open the Site Dashboard of the old site, go to the Live Environment and to the Domains / HTTPS tab.
- Remove the domain and subdomains you will be moving to the new site.
Add the Domain(s) to the New Site
- From another browser tab, open the Site Dashbard of the new site, go to the Live Environment and to the Domains tab.
- Add the custom domains
- Verify that you have the correct DNS records
Update the DNS Records
- Update your DNS host with the records from above.
Verify Your changes
Your new site is now live and receiving web traffic (although it may take a bit for the DNS settings to propagate). You can check on the state of propagation around the world with a free web tool like https://www.whatsmydns.net/
Downgrade Old Site
- Once you've confirmed that the new site is live, you can return to the old site and downgrade the plan to sandbox (free).
If you're using an existing credit card profile for billing, the credit from the sandbox downgrade will apply as a prorated payment for your new site. As long as you use the same card/site owner the credit will be carried over automatically.
If you are changing the card or the site owner, let us know when everything is switched over, and we'll apply that credit to the new account. Please do not remove the old credit card from your account until after the transfer has been made.