Manually configure URLs

By default, CloudCannon automatically detects the output URLs for your files and assigns them at build time. This is useful because you do not need to assign an output URL to each file yourself.

However, this behavior may not be right for your Site if it has a large number of files or a custom Site configuration. On these Sites, automatic URL detection can slow down your build time. To avoid this, you can disable automatic URL detection and configure your output URLs manually.

You can set the output URL for a Collection in the Data Editor by opening your cloudcannon.config.yml file from your File Browser, or from the Collection Browser by turning on Configuration Mode and clicking the Edit Advanced button. Enter a value in the URL field for every output Collection on your Site. For more information, please read our documentation on updating the output URL for a Collection.

To disable automatic URL detection:

1. Navigate to the Configuration page under Site Settings.
2. Check the Manually Configure URLs checkbox under Build system options.
3. Click the Update Configuration and Build button.

CloudCannon will immediately build your Site using the manually configured URLs.

If you would prefer to configure the output URLs for your Collections in the Source Editor or your local development environment, you can achieve the same configuration with the following code:

collections_config:
  blog:
    path: content/blog
    url: /travel/[slug].html

{
  "collections_config": {
    "blog": {
      "path": "content/blog",
      "url": "/travel/[slug].html"
    }
  }
}