Marketpath CMS Developer Tutorial Series

Adding a Custom Domain

Last Updated 3/8/2018

This lesson walks you through adding a custom domain name to an account and how to associate domains with sites.

NOTE: Before you can add a custom domain name, be sure you can validate ownership of the site by having access to the domain's DNS or the ability to add a meta tag to the current website header.

Add a Domain to a Site

To add a domain to a site, click the Site panel in primary navigation and then Site Settings.

null

Now click Domains and then click Add Domain.

null

This will bring up the Add Domain to Site dialog. Type your full domain name (e.g. "www.mydomain.com") into the Custom Domain text box. When you're done typing, your domain will automatically be checked for availability and for any previous verification. If it is new you will be required to verify it.

null

Now, select a Verify method. You may choose from one of three verification methods 1) DNS: Add a TXT record, 2) DNS: Add a CNAME record, or 3) HTTP: Add a Meta tag. Follow the instructions for whichever method you choose. Keep in mind that DNS changes may not fully propagate to all of your domain's name servers, so give it a couple minutes (or possibly longer) before you click the Verify Domain button.

null

Once you've completed the instructions and are confident the change has fully propagated, click Verify Domain. If the domain is verified you'll see the message Domain verified successfully! A checkbox will appear asking if you want to create a redirect for the root or www version of the domain, depending on which you've added. We recommend doing this. If you added mydomain.com, for example, it will ask you to create a redirect for www.mydomain.com. Click Save to add the domain to your site.

Redirect domains are free to add. Additional custom domains that are not redirects will incur an additional monthly fee.

Setting a default domain

Once you've added a custom domain to a site we recommend setting it as the default domain. In the Site Domains dialog, click the new custom domain and then click Make Default. All new URL's will then default to this domain. To update all existing URL's you'll need to perform a domain Swap. This is explained in a later lesson.

Domain properties

While in the Site Domains dialog, you can click each domain and make adjustments to it. There may be a note explaining that the domain is not resolving to the correct endpoint (i.e. CMS Live Server). You'll need to fix this before you can load your site with the custom domain.

You can also change SSL settings from this dialog. Here you have three options.

  1. The free SSL certificiate will be auto-generated after the site goes live. Set the domain to Either (default) or Require. This may take up to an hour to complete after go-live.
  2. You can complete additional domain validation for the SSL provider by clicking Start Validation and following the steps indicated. This is different than verifying the domain for Marketpath CMS.
  3. You can upload your own SSL certificate by clicking Add Custom SSL Certificate.

domain-properties

Adding a Domain to an Account

All domains are tied directly to the account used by the site. But you can also add domains directly to an account by clicking the upper-right cog icon and then Accounts. Select the Account you want and then click Domains. The process of adding a domain is similar to the steps above, except you cannot add a development domain and it will not be associated with a site when completed.

Once added, you will be able to add that domain to any sites within the same Account.

Verified Domains

Once you verify a sub-domain like www.mydomain.com, the parent domain will be added to the verified domain list for your account. Any subsequent domain additions will bypass the verification process altogether and allow you to quickly add sub-domains.

---- End of Lesson ----

Question? Correction?

Let's work together to make our documentation as helpful as possible.

What is your name? 
What is your email address? 
Feedback: