Custom domains are available for any sites on a paid plan.

Important Notes

Before starting adding a custom domain there are a few key things to note:

  • DNS servers or providers should accept the DNS records start with _  (underscore/underbar) for verifying domains. Please ask your DNS provider supports underscore DNS records.
    Some DNS providers support underscore records: Route 53, GoDaddy, NameCheap, Name.com and MuuMuu Domain.
  • Modifying TXT or MX/Email records is not required for setting up a custom domain. Changing those records may result in unexpected outcomes. The only records related to setting up a custom domain name on Shifter are CNAMES, ANAMES, or ALIAS, depending on your DNS provider.

 

How Shifter Custom Domains Work

Shifter uses CNAMES for custom domains. This works like a "mask" of the Shifter domain created with each site.

For example, example-site.on.getshifter.io is masked with example-site.com.

Using without www sub domains

If you want to assign a non-www domain such as example.com, your DNS provider must support ALIAS  Records.
Non-www domains are commonly referred to as naked or apex domains. If you are not sure if your DNS provider supports them, contact your provider or check their documentation.
The following DNS providers supports ALIAS /ANAME  records

Adding a Custom Domain

Before we can add a custom domain name we must first verify the domains ownership to assign domain and enable HTTPs for your website. It will help ensure that all site traffic is secure. HTTPs is required for all Shifter sites and is enabled by default.

Once your domain is verified and ready we'll be adding a CNAME record like the below to enable that custom domain.

www-prefixed domain (www.example.com)

Custom  URL    www.example.com
Shifter URL    example-123.on.getshifter.io
 | Host or Name | Type  |         Value                |
 | www          | CNAME | example-123.on.getshifter.io |

naked domain (example.com)

Custom  URL        example.com
CloudFront Domain  1e2x3a4m5p6l7e8.cloudfront.net
 | Host or Name | Type  |         Value                |
 | @          | ALIAS | 1e2x3a4m5p6l7e8.cloudfront.net |

Before jumping into the specifics, here's a brief overview of how-to enable a custom domain on Shifter.
Shifter uses only CANAME (or ANAME/ALIAS), if you have mail server (MX), do not delete or overwrite current records.
  

Step by step guide

Over view

  1. Verify ownership for your domain to enable HTTPs
  2. Create a CNAME record of your Custom URL
  3. Generate your site for replacing old URLs with your Custom URL

 

1. Log into the Shifter Dashboard

https://go.getshifter.io/ 

 

2. Navigate to the "Domain Settings" of your site

3. Add a valid domain using the Add a Domain form

This sample sets main domain is example.com, alternative is www.example.com.

 

4. Copy your custom domains verification records

 

5. Add your verification records to your DNS

In this example, we are using Amazon's Route53 DNS service. Depending on your provider this screen may look different however, the steps are the same.

Note:  Once you added verification records and verified, do not delete them. We'll check them to automatically extend your domain name's SSL/HTTPS expiration date. SSL/HTTPS will be expired and no longer updated if you delete verification records.

www prefixed domain (www.example.com)

| Name  | _cdf6d18fec87a7175aea77af0f8b598d.www
| Type  | CNAME
| Value | 42a5e0a2171b9111b23bb44420a7215e.ltfvzjuylp.acm-validations.aws.

naked domain (example.com)

| Name  | _5e12852794b8f43b88df40624efd93fc
| Type  | CNAME
| Value | 299dfb8f975137e2ca7a83b558cefa1b.ltfvzjuylp.acm-validations.aws.

 

6. Wait for the domain status to go from pending to verified

Successfully adding the these records correctly, it will only take a few minutes to validate your domain. Once valid, we can attach the domain for use.

Note: If you fail to validate your domain, make sure the added records to your DNS provider is not contain your domain name.
For example, if you input _abc123.www.your-domain.com , it should be _abc123.www  .

7. Attach your custom domain

Click [Attach] to assign domains to Site.

8. Create a CNAME record to mask the Shifter URL with a Custom URL

www prefixed domain (www.example.com)

  • Name: www 
  • Type: CNAME
  • Alias: Yes 
  • Value: example-123.on.getshifter.io  (*)
    * or alternatively, use CloudFront Domain.

Naked domain (example.com)

  • Type: A - IPv4 address
  • Alias: Yes
  • Alias Target:  d3aj2uwbxlcn56.cloudfront.net   (**)

** "CloudFront Domain" is available on "Site Settings" page of your Shifter dashboard

9. Generate a custom domain attached artifact

Please note. After attaching custom domain to and artifact, generate it again for replacing Shifter's URLs  (e.g. abcd-1234.on.getshifter.io) to your custom domain on your contents.

 

10. Access to attached custom domain.

That's all!

 

Did this answer your question?