All Articles

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.
Configuring uploads 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 To store and edit Markdown content in CloudCannon, we need to process it into HTML to make it editable. CloudCannon supports the CommonMark and Kramdown specifications. The implementations for these are markdown-it (JavaScript) and kramdown (Ruby).
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.
Optimizing your build by minifying CSS and JavaScript CloudCannon optimizes sites to load as fast as possible. CloudCannon minifies CSS with clean-css and JavaScript with Uglifier. Externally hosted assets are not optimized.
Syncing output files from CloudCannon to an external provider Configure an Output to commit the built version of your site to a repository.
Post processing 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.
Using live editing with vanilla JavaScript 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 No description.