Site mounting

Last modified: November 22nd, 2023

Working with a specific static site generator?
Customize CloudCannon's documentation to suit your SSG.

Great! We'll show you documentation relevant to .
You can change this any time using the dropdown in the navigation bar.

Site Mounting makes one site dependent on one or more other CloudCannon sites. Files from a remote site will be accessible to the local site at build time, and any updates to the remote site will trigger a build of the local site.

  • Local Site — The recipient of files from another site.
  • Remote Site(s) — The donor site.
  • Remote artifact — This determines which files are mounted and which events trigger new builds. You can set this to either Source files or Build output (available on Team and Enterprise plans).
  • Remote path — This determines the path/folder mounted to this site from the remote site. Leave this blank to mount the entire site's files.
  • Local path — This determines where CloudCannon will mount the remote files. This cannot be left blank.

You can have several remote sites mounted to one local site at a time. You can also mount one site to several other sites to create a content lake or common component hub. The number of connections per site and total number of mounted sites per Organization depends on your CloudCannon Plan.

  • Standard — 4 site mounts.
  • Team — 50 site mounts and 5 mounts per site.
  • Enterprise — 500 site mounts and unlimited mounts per site.

CloudCannon will prompt you to reduce your total site mountings before you can alter your pricing plan to one with a lower mounting limit.

Site Mounting is an alternative to relying on Git submodules, build hooks, or custom APIs to manage your site dependencies. You can use Site Mounting to:

  • Share components across multiple sites from a single source.
  • Aggregate content from multiple sites into a single content lake.
  • Set up a pre-generated headless API without GraphQL.

If you are on our Team or Enterprise plan, Site Mounting also unlocks the ability to mount the build output of a site in addition to its source files.

Mount a new site#

You can customize your settings on the Site Mountings page. To mount a site:

  1. Open the local site.
  2. Navigate to Site Mountings under Site Settings.
  3. Select your Remote Site. This site must be within the same Organization as the Local Site.
  4. Select your Remote artifact, Remote path, and Local path.
  5. Click the Mount site button.
  6. CloudCannon will add the site to your Sites mounted list.
A screenshot of the CloudCannon app shows the Site Mountings page, with a section to add a mounted site to the local site.

Remove a mounted site#

You can customize your settings on the Site Mountings page. To remove a mounted site:

  1. Open the local site.
  2. Navigate to Site Mountings under Site Settings.
  3. Identify the mounted site you want to remove and click the Context Menu icon in the top right corner.
  4. Click the Unmount button.
  5. On the Confirm unmount site pop-up window, click Unmount. Click again to confirm.
  6. CloudCannon will remove the site from your Sites mounted list.
A screenshot of the CloudCannon app shows the Site Mountings page, with a context menu to unmount a site from the local site.
Open in a new tab