Pre Go-Live: Site Domain Swap
Last Updated 1/11/2018
This tutorial shows you how to get your site ready for go-live if you used a free development domain or if you want to change custom domain.
If you developed your site using a free development domain and have not yet added a custom domain then add one now. You can learn about this in the lesson for Adding a Custom Domain. If you developed your site strictly with the Preview Site and used your own custom domain for all pages then you can skip this entire lesson.
Once your custom domain is added, you'll need to perform a domain swap to switch from your development domain to the production domain. A domain swap updates all url's for pages, menu items, etc. Default page url's are also updated for entities.
To trigger a site domain swap, you'll need to open Site -> Site Settings -> Domains and click the Swap button
Performing the Swap
In the Swap dialog, select the Old Domain that you've been using during development (the domain you'll no longer be using) and then select the New Domain you want the site to begin using. If you want to republish everything after the domain swap click the Republish checkbox.
If everything looks good, click Save and the domain swap will begin immediately. Once completed and if successful, you'll be prompted with the following success dialog.
Be sure to open the Site Domain properties dialog by clicking on it in the domains list. Then click Publish to ensure it gets published to the Live Server.
As of 1/11/2018 there are a few known issues with the domain swap. These are described below along with the steps you'll need to take to complete the process.
- Hard coded domains within user editable content areas will not be updated. You'll need to walk through your pages and templates to ensure there are no links with the old domain.
- Menu items are not republished. You will need to republish all menu items manually. Luckily, you can click on a menu item list, select all items, then click Publish.
- Entities are not republished. You will need to republish all entities with a page so their default page url is updated properly. You can do this by opening All Content, opening the advanced filters and then setting filter by has page to has page and filter by status to published. You might want to change your Show count to the max of 200 so it shows the most items. Then select all items and click Publish.
Let's work together to make our documentation as helpful as possible.