Scheduling your next build automatically

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:

  1. Run date
  2. Build name
  3. Source filename

For example:

_schedule.txt
2020-10-22T10:00:00+00:00,Publish Post,_posts/2020-10-22-because-of-the-internet.md

These values are used to schedule a build and generate the management UI.

Generating the schedule

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

For Jekyll sites we recommend using our plugin, jekyll-cloudcannon-schedule to generate _schedule.txt. This will parse all posts set for the future and generate a build on that date.

Note

If automatic builds are not working, try setting –-future in Site Settings / Configuration.

Build Status Gem Status

Add the following to your Gemfile:

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

Then add the following to your _config.yml:

_config.yml
plugins:
  - jekyll-cloudcannon-schedule
Note

For Jekyll versions before 3.5.0, use gems instead of plugins.

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
Automatic Builds Schedule interface
Was this article helpful? or Suggest an improvement >

Other Resources

  1. Jekyll CloudCannon Schedule