Define a custom configuration file path

Last modified: November 20th, 2025

Permissions required

Members of the Owners or Developers Default Permission Groups, or Custom Permission Groups with the x permission, can...

By default, CloudCannon looks for your CloudCannon Configuration File in the root directory of your Git repository. If your Configuration File is in a nested folder, you must define a custom file path.

To define a custom configuration file path:

  1. Navigate to the Details page under your Site Settings.
  2. Under CloudCannon Configuration Path, enter the file path for your CloudCannon configuration file in the text field. Note: this file must have the .json, .yaml, or .yml file extension.
  3. Click the Update Details button.

CloudCannon will now preferentially use the configuration file at this file path.

A screenshot of the Details page under Site Settings shows the CloudCannon Configuration File path text field.

Open in a new tab