☁️ Loving our new documentation website? Provide feedback in the CloudCannon Community! ✨

cascade

Table of contents

Description:

This key defines whether CloudCannon should merge this input configuration with any matching, less specific configurations elsewhere in the configuration cascade.

The configuration cascade works by finding the most specific _inputs entry.

Usually, once an option is found in the cascade, there's no reason to keep looking.

When this key is true, the cascade continues looking and each entry found is merged.

This key allows you to define some options globally while using specific options for other keys at different levels of the cascade.

For example, define a comment globally, but use collection-specific label for inputs in different collections.

You can stop the cascade at any point in the configuration cascade by setting cascade to false.

Appears in:
└── _inputs
    └── *
        ├── Text Input
        │   └── cascade
        ├── Textarea Input
        │   └── cascade
        ├── Code Input
        │   └── cascade
        ├── Color Input
        │   └── cascade
        ├── Boolean Input
        │   └── cascade
        ├── Number Input
        │   └── cascade
        ├── Range Input
        │   └── cascade
        ├── Rich Text Input
        │   └── cascade
        ├── Date/Datetime Input
        │   └── cascade
        ├── Time Input
        │   └── cascade
        ├── File Input
        │   └── cascade
        ├── URL Input
        │   └── cascade
        ├── Select Input
        │   └── cascade
        ├── Multiselect Input
        │   └── cascade
        ├── Choice Input
        │   └── cascade
        ├── Multichoice Input
        │   └── cascade
        ├── Object Input
        │   └── cascade
        └── Array Input
            └── cascade
Type:
boolean
Default value:
true
Examples:

In this example, we have configured cascade to merge input configurations across the configuration cascade.

Copied to clipboard
_inputs:
  title:
    type: text
    cascade: true
    comment: Global comment for all title inputs
{
  "_inputs": {
    "title": {
      "type": "text",
      "cascade": true,
      "comment": "Global comment for all title inputs"
    }
  }
}
Open in a new tab