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#
_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.
- Run date: Defines the date and time your build will be scheduled for.
- Build name: A label that will be shown in the Scheduled Builds UI in CloudCannon.
- 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.
Generating the schedule#
For convenience, it's likely you'll want to generate
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.
If automatic builds are not working, try setting
–-future in Site Settings / Configuration.
Add the following to your
Then add the following to your
For Jekyll versions before 3.5.0, use
gems instead of
There are no automatic methods for generating a schedule file in Hugo. You will need to output the file from your own templating or build hook.
There are no automatic methods for generating a schedule file in Eleventy. You will need to output the file from your own templating or build hook.
There are no automatic methods for generating a schedule file in other SSGs. You will need to output the file from your own templating or build hook.
Viewing automatic builds#
_schedule.txt is correctly set up, your site will be built automatically at the specified times.
To view all available automatic builds:
- Go to Site Settings / Schedule
- Select the Automatic tab
- Clicking Update will open the source filename in the content editor