Blog CMSBlog CMS
Docs/Publishing

Custom domains

Connect a subdomain (blog.yoursite.com) or a subfolder (yoursite.com/blog).

Your blog should live on your domain so the SEO value builds your brand. Blog CMS supports two setups: a subdomain or a subfolder. Pick whichever fits your site.

Subdomain vs. subfolder

  • Subdomain — blog.yoursite.com. Simplest to set up; uses a DNS record.
  • Subfolder — yoursite.com/blog. Keeps everything under one hostname, which some teams prefer for SEO; uses a proxy/reverse-proxy rule on your side.

Both serve the same fast static pages. The choice is about structure and preference, not features.

Setting up a subdomain

  1. In your blog's settings, choose the subdomain option and enter the host you want (for example blog.yoursite.com).
  2. Add the DNS record we show you at your domain registrar or DNS provider.
  3. Wait for DNS to propagate — this can take from a few minutes up to a few hours.
  4. Deploy. Your posts go live at the subdomain.

Setting up a subfolder

Serving your blog from yoursite.com/blog means your existing site forwards that path to Blog CMS. In your settings, choose the subfolder option and follow the proxy instructions for your stack. Common platforms (and most reverse proxies) support a rule that points /blog to your Blog CMS endpoint. Once the rule is in place, deploy and your posts appear under the folder.

Verifying it works

After setup and a deploy:

  • Visit your subdomain or /blog path in a browser.
  • Confirm a published post loads with your theme applied.
  • Check that the auto-generated sitemap and robots.txt are reachable — these support SEO essentials.

Common issues

  • Nothing loads yet — DNS may still be propagating. Give it time and re-check.
  • Wrong content at the path — for subfolders, confirm your proxy rule targets the exact Blog CMS endpoint we provide.
  • Mixed content or redirects — make sure your domain serves over HTTPS and isn't redirecting the blog path elsewhere.

Changing your setup later

You can switch from a subdomain to a subfolder (or vice versa) from settings. Update the corresponding DNS or proxy configuration and deploy again. Existing posts carry over.

Once your domain is connected, move on to Deploying your blog. Need a hand with DNS or proxy rules? Email [email protected] and we'll help you get it pointing correctly.