Content Folders

Content folders are a way to organize your pages/files. Most of the time, the static site generator (SSG) you are using defines the location where you store your content.

To make sure that Front Matter CMS can find your content and create the content in the correct place, you need to register the content/page folders.

Registering content folders

The registration of the page folders is typically performed during the setup of the CMS: Step 3: Register content folder(s), but you can perform changes at any time.

Content folders are stored in the frontMatter.content.pageFolders setting.

{
  "frontMatter.content.pageFolders": [
    {
      "title": "Pages",
      "path": "[[workspace]]/content",
      "excludeSubdir": true,
      "previewPath": "post" // Prefixes all files with "/post/" for the page preview
    },
    {
      "title": "Blog posts",
      "path": "[[workspace]]/content/posts"
    },
    {
      "title": "Glob pattern support",
      "path": "[[workspace]]/content/**/docs"
    },
    {
      "title": "docs",
      "path": "[[workspace]]/docs",
      "filePrefix": "",
      "contentTypes": ["doc"]
    },
    {
      "title": "archive",
      "path": "[[workspace]]/archive",
      "filePrefix": "",
      "disableCreation": true // Disables the creation of new content in this folder
    },
    {
      "title": "Multilingual",
      "path": "[[workspace]]/docs/en",
      "filePrefix": "",
      "defaultLocale": "en",
      "locales": [
        {
          "title": "English",
          "locale": "en"
        },
        {
          "title": "German",
          "locale": "de",
          "path": "../de"
        },
        {
          "title": "Nederlands",
          "locale": "nl",
          "path": "../nl"
        }
      ]
    }
  ]
}

Once the content folders are registered, you can create content with Front Matter CMS.

Register a new content folder

Settings view

You can make use of the settings view to easily add a new content folder.

To open the settings view, click on the gear icon in the top right corner in any of our dashboards.

1. Click on the "Content folders" tab.
2. Click on the folders which you want to add as a content folder.

Explorer view

You can also add a new content folder by right-clicking on a folder in the explorer view and clicking on Register folder under the Front Matter CMS context menu.

Properties

Important: [[workspace]] is a placeholder that the extension uses to replace the workspace path. The reason why we choose to use this, is because some do not keep the original folder name.