Scheduling your next build automatically

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

Astro

Bridgetown

Docusaurus

Eleventy

Gatsby

Hugo

Jekyll

Lume

MkDocs

Next.js

Nuxt

Static

SvelteKit

Custom

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

Automatic builds are configured by creating a _schedule.txt file in your site. After building your site, CloudCannon will read your _schedule.txt file and automatically configure a build at the specified time. This is useful for future posts.

Schedule file format#

The _schedule.txt is a comma separated list of values. It contains three values, which are used to schedule a build and generate the management UI.

1. Run date: Defines the date and time your build will be scheduled for.
2. Build name: A label that will be shown in the Scheduled Builds UI in CloudCannon.
3. Source filename: Path to a source file. The UI will show a button linking to the editor for that file. This is useful if you're scheduling a build to publish a particular file.

For example:

2020-10-22T10:00:00+00:00,Publish Post,_posts/2020-10-22-because-of-the-internet.md
2020-11-22T10:00:00+00:00,Publish Post,_posts/2020-11-22-the-history-of-marketing.md

Generating the schedule#

For convenience, it's likely you'll want to generate _schedule.txt programmatically.

group :jekyll_plugins do
  gem 'jekyll-cloudcannon-schedule'
end

plugins:
  - jekyll-cloudcannon-schedule

Viewing automatic builds#

When _schedule.txt is correctly set up, your site will be built automatically at the specified times.

To view all available automatic builds:

1. Go to Site Settings / Schedule
2. Select the Automatic tab
3. Clicking Update will open the source filename in the content editor