Accessing and configuring your invoices
Learn how to access and configure your invoices in CloudCannon.
Add Files with Direct Upload
Learn how to directly upload files to your static site with CloudCannon.
Add Project Links to make common tasks even quicker
Learn how to add Project Links to your CloudCannon project dashboard. You can use these to navigate to external resources, or often-used parts of the app.
Adding comments to your inputs in the data editor
Learn how to add comments to your inputs in CloudCannon. Comments add additional context for your editors, and will show up in the data editor when editing data files or front matter.
Adding i18n to your site for global audiences
Make your website more accessible to an international audience.
Adding password authentication to your site
Require a password to access your site.
Adding SAML authentication to your site
Restrict access to your site by using a third-party login service.
Adding unique instance values for new data
Unique instance values are hydrated at create time.
Adding user account authentication to your site
Restrict access to your site to a set of users you invite.
Adding your brand to your CloudCannon account
Learn how to make your CloudCannon account feel like home by adding your own custom branding.
Allowing users to logout from your site
Provide a logout button on your authenticated pages.
Array Structures reference
A list of key options for using Array Structures.
Building a site with a template
Explore the CloudCannon CMS with one of our simple templates.
Caching Gem installs to reduce build times
To save time on consecutive builds, CloudCannon can cache Gem installs.
Caching specific folders to reduce build times
Learn how to choose specific files and folders to cache between builds with CloudCannon. This can let you bypass install steps, speeding up subsequent builds.
Changing items in your site navigation
Learn how to reorder, show/hide, and regroup sections within your CloudCannon site's navigation.
Changing the default editor path
Learn how to change the default editor path on CloudCannon.
Changing your SSG CLI options
Most static site generators offer a number of configuration options for use on the command line. Configure these and other CloudCannon-specific build options per site.
Choosing the editors for each file
Select the preferred editor and additional editors available to your team members for each file.
Choosing which pages require authentication on your site
Auth routes allow you to specify the routes you want to be authenticated and keep the rest public.
Choosing your SSG to start your build
CloudCannon sites can be configured to build using Jekyll, Hugo, Eleventy, Next.js or Static.
Support for Gatsby, Nuxt.js and SvelteKit is currently in private beta. Contact support if you would like to join the beta.
Configuring code editors
Learn how to change the appearance and behavior of your code blocks in CloudCannon to fit your use case and brand.
Configuring Custom Routing
Configure your CloudCannon's hosting by configuring a single json file.
Configuring Extensionless URLs
Extensionless URLs do not end with a trailing slash or a file extension.
Configuring rich text input options
Control the toolbar options for your clients or editors to increase focus on the content at hand. Set toolbar options for the Content Editor, Editable Regions and Rich Text inputs.
Keep a consistent file structure by setting up an uploads path structure. Images, documents, and other files in the editor are uploaded to this location.
Configuring your CMS
Learn about the three primary ways to configure your CloudCannon CMS.
Configuring your Markdown engine
Connecting a Bitbucket respository as your source
Learn how to connect a Bitbucket repository to your site with CloudCannon.
Connecting a GitHub respository as your source
Learn how to connect a GitHub repository to your site with CloudCannon.
Connecting a GitLab respository as your source
Learn how to connect a GitLab repository to your site with CloudCannon.
Connecting a self-hosted GitLab repository as your source
Learn how to connect a self-hosted GitLab repository as your source with CloudCannon.
Connecting your first site
Learn how to connect your existing site to CloudCannon.
Creating custom 404 pages
Create your own 404 page to blend in with the rest of your site.
Creating a form for your site on CloudCannon
Create forms on your site and send the submissions to an email address or integrate with your own workflows.
Creating a new Organization
Learn how to create a new Organization in CloudCannon.
Setting up git workflows and branching sites
Learn how you Git-based workflows in the CloudCannon CMS
Creating backups of your source files
Learn how to create backups of your source files with CloudCannon.
Custom SSL certificates for your sites hosted on CloudCannon
Learn how to add custom PEM-encoded SSL certificates.
Customizing CloudCannon to match your brand
Learn how to customize CloudCannon to match your brand.
Customizing your inputs in the data cascade
CloudCannon offers different configuration options for each input and editor. Use this to improve the editing experience for your sites. Configuration can be set from a number of sources, from lowest priority to highest.
Defining editable regions in your HTML
Editable Regions let you edit parts of your HTML visually and with live updates.
Defining more ways to add new files
Learn how to create or change actions for the 'add' dropdown menu in CloudCannon's collection list.
Defining the default contents of new files
Learn how to provide default front matter and/or content for new collection items with CloudCannon.
Defining what adds to an array
Array add values allow you to define which keys in your data should be arrays, what data should be added when 'Add' is clicked, and how the editor can decide what item to add.
Defining your collections
Collections allow you to show groups of related content in the Site Navigation. Each collection corresponds to a folder in your site files. Navigating to a collection shows a preview of each file and allows your editors to see all the content at a glance.
Defining your SSG version
It's good practice to specify which version of your static site generator you use, to avoid errors and unexpected behavior. CloudCannon offers different methods to manage this based on which generator you use.
Detecting when your site is loaded in the visual editor
You can define situations where you want to show content to editors when they’re in the Visual Editor, but not show it on the live site.
Disabling authentication on your site
How to turn off authentication for your CloudCannon site.
Disabling editor publishing
Learn how to disable editor publishing with CloudCannon.
Editing markdown in the Visual Editor
Learn how to edit your markdown files as they would appear on your live site, with CloudCannon.
Editing Objects in your data
Objects can contain any type of data, including more Objects. This can continue indefinitely, going as deep as your code needs to.
Editor merging and pull requests with publishing
Learn how to merge and create and review pull requests with publishing workflows on CloudCannon.
Enabling editor branching with Projects
Learn how to group multiple sites from the same repository together with CloudCannon.
Extending in app navigation with Editor Links
Editor Links allow you to link to other sections of the CloudCannon interface from within the Visual Editor. Use them to create edit buttons for your collection items and blog posts to quickly navigate the app. You can also add front matter Editor Links to open the front matter Editor at specified fields.
Extending your build process with hooks
Bash scripts that run at different stages in the build to extend the functionality of your sites. There are three hooks available: Preinstall, Prebuild, and PostBuild. All three are configured using extensionless script files.
Giving clients access to update a site
Learn how to share your site with your clients, without them having to create a CloudCannon account and use a seat on your pricing plan.
Hiding inputs in the data editor
Find out how to hide options and potentially destructive actions in CloudCannon's editor.
Hosting your sites
Learn about your options for hosting a site with CloudCannon.
Hosting your site on a custom domain
Attach your own domain to a site on CloudCannon.
How CloudCannon handles failed payments
After a failed payment, we try to give you plenty of time to set up a new payment method.
How to choose what input is used in the Data Editor
The Data Editor can use a wide range of different inputs; you can set the input type by using a naming convention in the variable name.
How to pay for CloudCannon
We currently accept Visa and Mastercard credit cards for payment for paid plans and invoicing on Enterprise plans.
How do I use a custom Gemfile with Jekyll?
Change your default gem source.
Working with your team and clients
Learn how to add your team members to CloudCannon, and share editing with those outside of your team.
HTTPS support for your sites hosted on CloudCannon
Secure your site with SSL.
Introducing the Content Editor
Use CloudCannon's Content Editor to give your whole team a straightforward and intuitive editing experience.
Introducing the Data Editor
Easily manage the content of YAML, TOML, JSON, CSV, and TSV files.
Introducing the site dashboard
A breakdown of the main sections of a site.
Introducing the Source Editor
A code editor in the browser.
Introducing the Visual Editor
Visually navigate and edit the content on your site.
Introducing your site navigation
Learn about to get around with your site navigation in CloudCannon.
Learning with the Developer Demo
Explore the basics of setting up your files for editing in the CloudCannon CMS with our Developer Demo.
Live editing with Svelte
Live editing on CloudCannon with Svelte. Edit Front Matter and see the changes show up live.
Managing your node version with nvm
CloudCannon uses the LTS (v14.16.0) version of node by default. You can use nvm to select which node version to use with your build.
Managing your Ruby version
CloudCannon supports Ruby versions using rbenv. Jekyll sites without the version specified default to version 2.7.x.
Managing your team members
After creating an Organization, your account is set up as the owner. There are 4 main types of users in an Organization.
Syncing output files from CloudCannon to an external provider
Configure an Output to commit the built version of your site to a repository.
Configure CloudCannon processes that run after your site builds.
Disable CloudCannon window global in the visual editor
CloudCannon injects an object onto the window object when viewed in the visual editor. This article will show how to turn off this behaviour.
Reading form submissions in your inbox
Once you have correctly added a form to your site, you can view responses in the CloudCannon inbox.
Recovering access to your organization
Resolve Organization ownership conflicts.
Reducing spam by adding Google reCAPTCHA
Protect form submissions from automated spam.
Resolving ownership over a custom domain
When resolving ownership issues, we do our best to protect all parties involved during these processes. If we are asking for proof of ownership, it is well-intentioned.
Saving files from your build back to your source
You can configure CloudCannon to commit built/generated files back to your source repository. This ensures that any generated files are consistent between CloudCannon and your source repository.
Scheduling your builds manually
Manually scheduled builds are configured in the CloudCannon UI. They are useful for regular period builds or one-off future builds.
Scheduling your next build automatically
After building your site, CloudCannon will read your _schedule.txt file and automatically configure a build at the specified time.
Setting up a publish branch with merging or pull requests
Learn how to set up a publish branch with merging or pull requests, with CloudCannon.
Sharing on a per-site basis
Share a site with others by creating Collaborators.
Transferring sites between Organizations
Transfer the ownership of a site to another Organization.
Unlisting files in a collection
Hide specific files in a collection so your team members don't accidentally edit them. These files are still used in your site build.
Using a modal with Array Structures
A modal with search, tagging, and bigger images is available when the number of array structures you add becomes far too many to manage with a dropdown.
Using Arrays to edit your data
Arrays can be used for a wide range of use cases, from small lists of strings to full component builders.
Using Arrays for a gallery
Learn how to set the structure for new items in a gallery array.
Using Bearer Tokens to authenticate with your site
Require a secret token in your request headers to authenticate the request.
Using Checkbox Inputs to edit your data
Checkboxes can be triggered on or off.
Using CloudCannon DNS to configure your custom domain
A fast, scalable DNS service automatically configured for your site.
Using Code Inputs to edit your data
Configurable editor for blocks of code or monospace content.
Using Color Inputs to edit your data
Input with dropdown for selecting color.
Using Date and Time Inputs to edit your data
Combination date picker and 12-hour time input.
Using External DNS to configure your custom domain
Use your own DNS servers.
Using geolocation to detect your user's country
Customize content based on the location of the visitor.
Using live editing with React
Live editing on CloudCannon with React. Edit Front Matter and see the changes show up live.
Live editing on CloudCannon with vanilla JS. Roll your own live previews by hooking into document events.
Using Number Inputs to edit your data
Input field for numbers.
Using Rich Text Inputs to edit your HTML and Markdown data
Give your editors ultimate control by allowing them to write markup directly into your data files.
Using select inputs to edit your data
Keep data linked and consistent by providing a fixed or dynamic set of options for select or multiselect inputs. Inputs are selects or multiselects if their keys match a naming scheme linking to a data set source.
Using Social Inputs to edit your data
Change the appearance of your text fields with social network icons.
Using Single Sign On to create team member accounts
Enforce Single Sign On for your team members and increase security by using CloudCannon with SAML.
Using Text Inputs to edit your data
Edit strings in your data.
Using upload inputs to edit your data
Allow editors to upload new files, select existing images, and add external links.
Using URL Inputs to edit your data
Input field with a preview for absolute or fully qualified URLs.
Viewing your site on a testing domain
Every site on CloudCannon has a matching .cloudvent.net URL. Use this to test on a live site, without having to set up your own domain.
What is an Organization
Organizations help you organize your team, sites and resources in one place.
What is CloudCannon?
An overview of the benefits of building static sites on CloudCannon.
What is live editing
Live editing on CloudCannon lets your editors see exactly what they are changing as they change it.
What version of Go is used in the build environment
Currently, the only installed Golang version is 1.15.7-linux/amd64.
Where to define your configuration
The CloudCannon editing interfaces rely on a JSON file which contains information about your site. CloudCannon generates this JSON file when your site builds. Depending on your static site generator, either a plugin or command line tool is used to create the file.
Why CloudCannon injects width and height onto images
CloudCannon automatically adds size attributes (width, height, sizes) to the HTML for images uploaded in the Content Editor and Editable Regions.
Deprecated 301.txt Redirects
301.txt redirects are deprecated, use routing.json to configure this with more options.
How do I manage the build plugin manually?
By default, CloudCannon injects the eleventy-plugin-cloudcannon package into your site. If defaulty setting clashes with your build, you can manage this manually.
Patching YAML number parsing for Jekyll