Site configuration covers the files you add to your repository to customize how CloudCannon builds and edits your site. These files live alongside your source code, so they are versioned with your project and apply every time CloudCannon builds.
Configuration File#
The CloudCannon configuration file (cloudcannon.config.*) is the primary way to customize your CloudCannon experience. It controls collections, inputs, editing interfaces, and much more.
View Configuration File Reference
Initial Site Settings File#
The initial site settings file (.cloudcannon/initial-site-settings.json) streamlines the Site creation process by pre-configuring your SSG, hosting mode, and build settings.
View Initial Site Settings Reference
Routing File#
The routing file (.cloudcannon/routing.json) configures custom redirects and HTTP headers for CloudCannon hosted Sites.
Editable Regions#
Editable regions let you mark parts of your built HTML as editable, enabling content editing directly in the visual editor.
View Editable Regions Reference
Visual Editor API#
The Visual Editor API lets you connect your front end to CloudCannon's visual editor for live editing and visual data previews.
View Visual Editor API Reference
Schemas & Types#
CloudCannon provides JSON Schemas and TypeScript types for IDE autocomplete and validation when editing configuration files.
- JSON Schemas — for JSON and YAML configuration files
- TypeScript Types — for JavaScript and TypeScript configuration files