Set a default editing interface

Last modified: January 14th, 2024

Working with a specific static site generator?
Customize CloudCannon's documentation to suit your SSG.

Great! We'll show you documentation relevant to .
You can change this any time using the dropdown in the navigation bar.

Select the preferred editor and additional editors available to your team members for each file.

This option is set in the front matter of specific files. You can also set this globally, or for all files in a collection when defining your collections.

_enabled_editors - Array of strings#

Controls how your team edits specific files, use this to set a preferred editor and/or disable the others. The first value sets which editor opens from the collection list, the other values specify which editors are accessible. Available values are:

The Source Editor is always available for those with permission.

Front Matter
copied
_enabled_editors:
  - visual
  - content
Front Matter
copied
{
  "_enabled_editors": [
    "visual",
    "content"
  ]
}
Front Matter
copied
_enabled_editors = [ "visual", "content" ]

Hiding the content area#

When files only use the front matter, it is better to display a full-screen front matter editor. You can do this by specifying data as the first enabled editor, and then omitting content from the list of enabled editors.

For example, to hide the content editor for all files in a collection called posts:

cloudcannon.config.yaml
copied
collections_config:
  posts:
    _enabled_editors:
      - data
      - visual
cloudcannon.config.json
copied
{
  "collections_config": {
    "posts": {
      "_enabled_editors": [
        "data",
        "visual"
      ]
    }
  }
}
cloudcannon.config.js
copied
module.exports = {
  collections_config: {
    posts: {
      _enabled_editors: [
        "data",
        "visual"
      ]
    }
  }
};

This will set files in posts to open in the Data Editor by default, while still allowing the post to be opened in the Visual Editor. The Content Editor will be disabled.

Screenshot of a blog post open in the data editor

Related Articles

Open in a new tab