Introducing Subpaths

headshot of Mike smiling
Mike Neumegen
30 September 2019

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.

You might also be interested in

Illustration showing CloudCannon's Editor Panels

Component editing with Editor Panels

Dave Strydom

14 December 2021

Read more
Graphical representation of an _inputs key

Updated input configuration for your workflows


26 November 2021

Read more
Blog image for our new UI improvements

Sparking joy: CloudCannon UI improvements

Dave Strydom

12 November 2021

Read more
Don’t miss the latest
A monthly newsletter to keep you up-to-date with the latest CloudCannon news
Illustration of woman holding an envilope