Introducing Subpaths

By Mike Neumegen · 30 Sep 2019
Introducing Subpaths

Subdomains are a great way to separate different sections of your site. You might have your blog at, your docs at while keeping your main marketing site at Many companies use subdomains this way and it's easy to set up in CloudCannon.

Subdomains however, are not your only option. The alternative is mounting the sites on subpaths. So becomes and becomes SEO is the main benefit of doing this as your content is not split between multiple logical sites. Moz are thought leaders in the SEO space and have a great video outlining subdomains vs subpaths.

To achieve this you could create a monolithic Jekyll site that has your blog, docs and marketing site. If you have a small amount of content this works fine, however if you have a large amount of content your build times, content structure and site complexity will soon get out of control. It also means that each individual site can no longer have their own editors and publishing schedule.

Ideally you could build each site individually and mount them at the desired paths on build. The would give search engines and visitors the illusion of a single site when under the hood it's multiple sites. With CloudCannon subpaths you can do exactly this!

How do I use subpaths?

First set up a site using the primary domain, in the above situation this would be This site will serve the root and any routes that don't have a subpath.

subpaths dashboard

Once the primary domain is configured we can set the subpath for other sites.

subpaths dashboard

Now anything beginning with the path /blog/ is handled by the second site, everything else is handled by the first.

CloudCannon doesn't rewrite you generate so all links on the second site needs to be prepended with /blog/ (or whatever your subpath is) using Jekyll's baseurl or some other method.

Wrapping up

Subpaths allow you to split large sites into smaller, more manageable chunks. We hope this helps you create more complex sites on CloudCannon.

Launch your website today

Give your content team full autonomy on your developer-approved tech stack with CloudCannon.

Get started free!

You might also like: