New Launch

Take a deep dive into the fastest Gatsby, yet: Gatsby 5!

Apex and Subdomains


Adding a custom domain to your Gatsby Cloud site will add both the apex domain and “www” subdomain. This guide will show you how to configure these domains, and redirect between the two.

Adding the domain

  1. Add either an apex domain or www subdomain to your Gatsby Hosting configuration. You can read more about adding a domain in Adding a Custom Domain.

  2. You should see a redirect pair of domains with the domain you entered as a “Primary domain”.

List of connected domains

  1. Follow the directions for adding DNS records for both of the domains that are listed. The apex domain will need an A record pointed to an IP address and the subdomain will need a CNAME pointed at your Gatsby Hosting default URL, YOUR_SITE_PREFIX.

Switching the redirect

If you want the redirected domain to be the primary domain, click the “Make Primary” button on the right-hand side of the domain listing.

Button to change primary domain

Removing a domain from a redirect

To remove a domain from the redirect, click “Remove” on the right-hand side of the domain listing. The remaining domain will act as a non-redirected domain, regardless of whether it was the primary domain.

Button to remove a domain from a redirect

If you re-add the domain you just removed, both domains will act as primary domains without a redirect. If you need to re-add the redirect, remove both domains and start over.

Adding the domain to a redirect

Gatsby Cloud now allows you to redirect your domain to your primary domain. This ensures that search engines don’t index the domain. To do this:

  1. Next to where your domain is listed, click “Select Primary Redirect”.
  2. Select a Primary domain:

Gatsby Domain Redirect

All domains will 301 redirect to the primary domain that you select. A 301, or permanent, redirect is when the server signals to the browser that this page has been permanently moved to another location.

Edit this page on GitHub
© 2022 Gatsby, Inc.