Feedback: Setting for taxonomy front matter checks (assumed) #771

New Issue

Closed

opened 2026-10-05 03:04:40 +02:00 by adam · 3 comments

adam commented 2026-10-05 03:04:40 +02:00

Owner

Copy link

Copy source

I realised that the front matter plugin in my site suddenly stopped adding new items to the keyword database. It marks new tags as false with a note of all existing other tags to choose from.

Field 'tags.2' must be one of: a-tag, b-tag, all my many allowed tags in a list

Looking for the setting to enable the usage of any tag that I found this setting:

The text states "allow yourself from entering" so I assume it was "prevent" at some point or should be now. In summary this field description does not compute in my brain. It also in both of the checkbox states does NOT solve my issue.

1. How do I set globally "do not complain about non-existing tags in my front matter"?
2. Please fix the description of that option above ;)
3. If the above setting was the right one, maybe add something like "delete cache after setting" or "restart vscode" if there are any required actions.

Sidenotes:

• I added the tags via my content generation script as commaseparated list, not via FM sidebar
• "suddenly stopped" = I did not look at this part for quite a while, no config changes, other recent contents used tags that FM didn't complain about

FM Diagnostic logging:

Details

Front Matter CMS - Diagnostics

Beta: false
Version: 10.10.1
OS: linux
VSCode version: 1.121.0

Project name

kollitsch.dev

Workspace folder

/home/patrick/github.com/davidsneighbour/kollitsch.dev

Total files

Total files found: 14743

Folders

Title	Path
Weblog	/home/patrick/github.com/davidsneighbour/kollitsch.dev/src/content/blog/

Files in folders

Project start length	Search in	md	mdx	markdown
17	src/content/blog/**/*.*	180	0	0

Complete frontmatter.json config

{
  "$schema": "https://frontmatter.codes/frontmatter.schema.json",
  "frontMatter.content.publicFolder": {
    "path": "src/assets/images/",
    "relative": true
  },
  "frontMatter.framework.id": "astro",
  "frontMatter.preview.host": "http://localhost:4321",
  "frontMatter.taxonomy.slugTemplate": "{{title}}",
  "frontMatter.content.pageFolders": [
    {
      "$schema": "https://frontmatter.codes/config/content.pagefolders.schema.json",
      "contentTypes": [
        "default"
      ],
      "filePrefix": "{{date|yyyy}}/",
      "path": "[[workspace]]/src/content/blog/",
      "previewPath": "/{{fm.fmContentType}}/{{fm.date|format:yyyy}}/",
      "title": "Weblog",
      "trailingSlash": true,
      "extended": true
    }
  ],
  "frontMatter.data.files": [
    {
      "$schema": "https://frontmatter.codes/config/data.files.schema.json",
      "file": "[[workspace]]/src/content/blogroll.json",
      "id": "blogroll",
      "labelField": "name",
      "schema": {
        "properties": {
          "description": {
            "multiline": true,
            "title": "Description",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "rss": {
            "title": "RSS Feed URL",
            "type": "string"
          },
          "url": {
            "title": "URL",
            "type": "string"
          }
        },
        "required": [
          "name",
          "url"
        ],
        "title": "Blogroll",
        "type": "object"
      },
      "title": "Blogroll"
    },
    {
      "$schema": "https://frontmatter.codes/config/data.files.schema.json",
      "file": "[[workspace]]/src/content/categories.json",
      "id": "categories",
      "labelField": "label",
      "schema": {
        "properties": {
          "class": {
            "description": "CSS class for the category.",
            "type": "string"
          },
          "description": {
            "description": "The introduction for this category.",
            "multiline": true,
            "type": "string"
          },
          "icon": {
            "description": "Name of the category icon.",
            "type": "string"
          },
          "id": {
            "description": "The category's slug.",
            "type": "string"
          },
          "image": {
            "description": "The filename of the category image within the `src/assets/images/categories` directory.",
            "type": "string"
          },
          "label": {
            "description": "The category's label.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "label",
          "description",
          "image",
          "icon",
          "class"
        ],
        "type": "object"
      },
      "title": "Categories"
    },
    {
      "$schema": "https://frontmatter.codes/config/data.files.schema.json",
      "file": "[[workspace]]/src/data/socialmedia.json",
      "id": "socialmedia",
      "labelField": "label",
      "schema": {
        "properties": {
          "icon": {
            "description": "Name of the social media icon.",
            "type": "string"
          },
          "id": {
            "description": "The social media's slug.",
            "type": "string"
          },
          "label": {
            "description": "The social media's label.",
            "type": "string"
          },
          "url": {
            "description": "The URL of the social media profile.",
            "format": "uri",
            "type": "string"
          },
          "weight": {
            "description": "The weight of the social media link, used for sorting.",
            "type": "number"
          }
        },
        "required": [
          "id",
          "label",
          "url",
          "icon"
        ],
        "type": "object"
      },
      "title": "Social Media"
    },
    {
      "$schema": "https://frontmatter.codes/config/data.files.schema.json",
      "file": "[[workspace]]/src/content/tags.json",
      "id": "tags",
      "labelField": "label",
      "schema": {
        "properties": {
          "class": {
            "description": "CSS class for the tag.",
            "type": "string"
          },
          "description": {
            "description": "The introduction for this tag.",
            "multiline": true,
            "type": "string"
          },
          "icon": {
            "description": "Name of the tag icon.",
            "type": "string"
          },
          "id": {
            "description": "The tag's slug.",
            "type": "string"
          },
          "image": {
            "description": "The filename of the tag image within the `src/assets/images/tags` directory.",
            "type": "string"
          },
          "label": {
            "description": "The tag's label.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "label",
          "description",
          "image",
          "icon",
          "class"
        ],
        "type": "object"
      },
      "title": "Tags"
    }
  ],
  "frontMatter.media.contentTypes": [
    {
      "$schema": "https://frontmatter.codes/config/media.contenttypes.schema.json",
      "fields": [
        {
          "name": "title",
          "title": "Title",
          "type": "string"
        },
        {
          "name": "author",
          "title": "Author",
          "type": "string"
        },
        {
          "name": "alt",
          "title": "Alt text",
          "type": "string"
        },
        {
          "name": "imageid",
          "single": true,
          "title": "Image ID",
          "type": "string"
        },
        {
          "name": "source",
          "single": true,
          "title": "Source",
          "type": "string"
        }
      ],
      "fileTypes": [
        "png",
        "jpg",
        "jpeg",
        "gif"
      ],
      "name": "default"
    }
  ],
  "frontMatter.taxonomy.contentTypes": [
    {
      "$schema": "https://frontmatter.codes/config/taxonomy.contenttypes.schema.json",
      "fields": [
        {
          "name": "title",
          "title": "title",
          "type": "string"
        },
        {
          "name": "description",
          "title": "description",
          "type": "string"
        },
        {
          "name": "draft",
          "title": "draft",
          "type": "draft"
        },
        {
          "name": "date",
          "title": "date",
          "type": "datetime"
        },
        {
          "fieldGroup": [
            "resources_group"
          ],
          "name": "resources",
          "title": "resources",
          "type": "block"
        },
        {
          "name": "tags",
          "title": "tags",
          "type": "tags"
        },
        {
          "name": "fmContentType",
          "title": "fmContentType",
          "type": "string"
        },
        {
          "fields": [
            {
              "name": "src",
              "title": "src",
              "type": "string"
            },
            {
              "name": "title",
              "title": "title",
              "type": "string"
            }
          ],
          "name": "cover",
          "title": "cover",
          "type": "fields"
        },
        {
          "name": "publisher",
          "title": "publisher",
          "type": "string"
        }
      ],
      "name": "default",
      "pageBundle": true
    }
  ],
  "frontMatter.taxonomy.fieldGroups": [
    {
      "$schema": "https://frontmatter.codes/config/taxonomy.fieldgroups.schema.json",
      "fields": [
        {
          "name": "title",
          "title": "title",
          "type": "string"
        },
        {
          "name": "src",
          "title": "src",
          "type": "string"
        }
      ],
      "id": "resources_group"
    }
  ]
}

I realised that the front matter plugin in my site suddenly stopped adding new items to the keyword database. It marks new tags as false with a note of all existing other tags to choose from. ```plaintext Field 'tags.2' must be one of: a-tag, b-tag, all my many allowed tags in a list ``` Looking for the setting to enable the usage of any tag that I found this setting: <img width="1095" height="114" alt="Image" src="https://github.com/user-attachments/assets/5d6595cb-6949-42df-bf5b-42ffeee54f58" /> The text states "allow yourself from entering" so I assume it was "prevent" at some point or should be now. In summary this field description does not compute in my brain. It also in both of the checkbox states does NOT solve my issue. 1. How do I set globally "do not complain about non-existing tags in my front matter"? 2. Please fix the description of that option above ;) 3. If the above setting was the right one, maybe add something like "delete cache after setting" or "restart vscode" if there are any required actions. Sidenotes: - I added the tags via my content generation script as commaseparated list, not via FM sidebar - "suddenly stopped" = I did not look at this part for quite a while, no config changes, other recent contents used tags that FM didn't complain about FM Diagnostic logging: <details><summary>Details</summary> # Front Matter CMS - Diagnostics Beta: `false` Version: `10.10.1` OS: `linux` VSCode version: `1.121.0` ## Project name kollitsch.dev ## Workspace folder `/home/patrick/github.com/davidsneighbour/kollitsch.dev` ## Total files Total files found: 14743 ## Folders | Title | Path | | ----- | ---- | | Weblog | `/home/patrick/github.com/davidsneighbour/kollitsch.dev/src/content/blog/` | ### Files in folders | Project start length | Search in | md | mdx | markdown | |--- | --- | --- | --- | --- | | 17 | `src/content/blog/**/*.*` | 180 | 0 | 0 | ## Complete frontmatter.json config ```json { "$schema": "https://frontmatter.codes/frontmatter.schema.json", "frontMatter.content.publicFolder": { "path": "src/assets/images/", "relative": true }, "frontMatter.framework.id": "astro", "frontMatter.preview.host": "http://localhost:4321", "frontMatter.taxonomy.slugTemplate": "{{title}}", "frontMatter.content.pageFolders": [ { "$schema": "https://frontmatter.codes/config/content.pagefolders.schema.json", "contentTypes": [ "default" ], "filePrefix": "{{date|yyyy}}/", "path": "[[workspace]]/src/content/blog/", "previewPath": "/{{fm.fmContentType}}/{{fm.date|format:yyyy}}/", "title": "Weblog", "trailingSlash": true, "extended": true } ], "frontMatter.data.files": [ { "$schema": "https://frontmatter.codes/config/data.files.schema.json", "file": "[[workspace]]/src/content/blogroll.json", "id": "blogroll", "labelField": "name", "schema": { "properties": { "description": { "multiline": true, "title": "Description", "type": "string" }, "name": { "title": "Name", "type": "string" }, "rss": { "title": "RSS Feed URL", "type": "string" }, "url": { "title": "URL", "type": "string" } }, "required": [ "name", "url" ], "title": "Blogroll", "type": "object" }, "title": "Blogroll" }, { "$schema": "https://frontmatter.codes/config/data.files.schema.json", "file": "[[workspace]]/src/content/categories.json", "id": "categories", "labelField": "label", "schema": { "properties": { "class": { "description": "CSS class for the category.", "type": "string" }, "description": { "description": "The introduction for this category.", "multiline": true, "type": "string" }, "icon": { "description": "Name of the category icon.", "type": "string" }, "id": { "description": "The category's slug.", "type": "string" }, "image": { "description": "The filename of the category image within the `src/assets/images/categories` directory.", "type": "string" }, "label": { "description": "The category's label.", "type": "string" } }, "required": [ "id", "label", "description", "image", "icon", "class" ], "type": "object" }, "title": "Categories" }, { "$schema": "https://frontmatter.codes/config/data.files.schema.json", "file": "[[workspace]]/src/data/socialmedia.json", "id": "socialmedia", "labelField": "label", "schema": { "properties": { "icon": { "description": "Name of the social media icon.", "type": "string" }, "id": { "description": "The social media's slug.", "type": "string" }, "label": { "description": "The social media's label.", "type": "string" }, "url": { "description": "The URL of the social media profile.", "format": "uri", "type": "string" }, "weight": { "description": "The weight of the social media link, used for sorting.", "type": "number" } }, "required": [ "id", "label", "url", "icon" ], "type": "object" }, "title": "Social Media" }, { "$schema": "https://frontmatter.codes/config/data.files.schema.json", "file": "[[workspace]]/src/content/tags.json", "id": "tags", "labelField": "label", "schema": { "properties": { "class": { "description": "CSS class for the tag.", "type": "string" }, "description": { "description": "The introduction for this tag.", "multiline": true, "type": "string" }, "icon": { "description": "Name of the tag icon.", "type": "string" }, "id": { "description": "The tag's slug.", "type": "string" }, "image": { "description": "The filename of the tag image within the `src/assets/images/tags` directory.", "type": "string" }, "label": { "description": "The tag's label.", "type": "string" } }, "required": [ "id", "label", "description", "image", "icon", "class" ], "type": "object" }, "title": "Tags" } ], "frontMatter.media.contentTypes": [ { "$schema": "https://frontmatter.codes/config/media.contenttypes.schema.json", "fields": [ { "name": "title", "title": "Title", "type": "string" }, { "name": "author", "title": "Author", "type": "string" }, { "name": "alt", "title": "Alt text", "type": "string" }, { "name": "imageid", "single": true, "title": "Image ID", "type": "string" }, { "name": "source", "single": true, "title": "Source", "type": "string" } ], "fileTypes": [ "png", "jpg", "jpeg", "gif" ], "name": "default" } ], "frontMatter.taxonomy.contentTypes": [ { "$schema": "https://frontmatter.codes/config/taxonomy.contenttypes.schema.json", "fields": [ { "name": "title", "title": "title", "type": "string" }, { "name": "description", "title": "description", "type": "string" }, { "name": "draft", "title": "draft", "type": "draft" }, { "name": "date", "title": "date", "type": "datetime" }, { "fieldGroup": [ "resources_group" ], "name": "resources", "title": "resources", "type": "block" }, { "name": "tags", "title": "tags", "type": "tags" }, { "name": "fmContentType", "title": "fmContentType", "type": "string" }, { "fields": [ { "name": "src", "title": "src", "type": "string" }, { "name": "title", "title": "title", "type": "string" } ], "name": "cover", "title": "cover", "type": "fields" }, { "name": "publisher", "title": "publisher", "type": "string" } ], "name": "default", "pageBundle": true } ], "frontMatter.taxonomy.fieldGroups": [ { "$schema": "https://frontmatter.codes/config/taxonomy.fieldgroups.schema.json", "fields": [ { "name": "title", "title": "title", "type": "string" }, { "name": "src", "title": "src", "type": "string" } ], "id": "resources_group" } ] } ``` </details> <!-- github-sync-id:4528645733 -->

adam closed this issue 2026-10-05 03:04:40 +02:00

adam commented 2026-10-05 03:04:41 +02:00

Author

Owner

Copy link

Copy source

It has to do with the new validation system on the markdown files that isn't yet aware of the freeform. That needs to be improved.

How do I set globally "do not complain about non-existing tags in my front matter"?

You can disable the new validation via the frontMatter.validation.enabled setting.

Please fix the description of that option above ;)

Ok, I'll make a better description.

If the above setting was the right one, maybe add something like "delete cache after setting" or "restart vscode" if there are any required actions.

It is related to the new setting and validation system.

It has to do with the new validation system on the markdown files that isn't yet aware of the freeform. That needs to be improved. > How do I set globally "do not complain about non-existing tags in my front matter"? You can disable the new validation via the `frontMatter.validation.enabled` setting. > Please fix the description of that option above ;) Ok, I'll make a better description. > If the above setting was the right one, maybe add something like "delete cache after setting" or "restart vscode" if there are any required actions. It is related to the new setting and validation system. <!-- github-comment-id:4552811503 -->

adam commented 2026-10-05 03:04:42 +02:00

Author

Owner

Copy link

Copy source

Feel free to give the fix a try in the latest beta version @davidsneighbour 🙏

Feel free to give the fix a try in the latest beta version @davidsneighbour 🙏 <!-- github-comment-id:4553015632 -->

adam commented 2026-10-05 03:04:43 +02:00

Author

Owner

Copy link

Copy source

Works as expected!

Works as expected! <!-- github-comment-id:4553579007 -->

Sign in to join this conversation.

No Branch/Tag Specified

Branches Tags

main

beta

dependabot/npm_and_yarn/js-yaml-4.3.1

dependabot/npm_and_yarn/multi-7958ac4c45

dependabot/npm_and_yarn/postcss-8.5.25

dependabot/npm_and_yarn/multi-670d462a53

dependabot/npm_and_yarn/http-proxy-middleware-2.0.10

dependabot/npm_and_yarn/shell-quote-1.10.0

dependabot/npm_and_yarn/websocket-driver-0.7.5

dependabot/npm_and_yarn/multi-6aaed2ab8e

copilot/validate-issue-1043

dependabot/npm_and_yarn/multi-84120a5570

dependabot/npm_and_yarn/launch-editor-2.14.1

dependabot/npm_and_yarn/multi-9dd3b9b346

estruyf/smart-file-rename

copilot/fix-unwanted-auto-update-publish-date

copilot/fix-content-view-sorting-issue

copilot/fix-virtual-workspace-folder-selection

copilot/fix-937

copilot/fix-965

copilot/fix-958

copilot/fix-950

copilot/fix-932

copilot-integration

hotfix/10.2.1

issue/816

issue/671

i18n

azure-translator

issue/747

issue/673

poc/content-tagging

combobox

v10.13.0

v10.12.0

v10.11.0

v10.10.1

v10.10.0

v10.9.0

v10.8.0

v10.7.0

v10.6.0

v10.5.1

v10.5.0

v10.4.1

v10.4.0

v10.3.0

v10.2.1

v10.2.0

v10.1.0

v10.0.2

v10.0.1

v10.0.0

v9.4.0

v9.3.1

v9.3.0

v9.2.0

v9.1.0

v9.0.0

v8.4.0

v8.3.0

v8.2.0

v8.1.2

v8.1.1

v8.1.0

v8.0.1

v8.0.0

v7.3.4

v7.3.3

v7.3.2

v7.3.1

v7.3.0

v7.2.0

v7.1.2

v7.1.1

v7.1.0

v7.0.0

v6.1.1

v6.1.0

v6.0.0

v5.10.0

v5.9.0

v5.8.0

v5.7.0

v5.6.0

v5.5.0

v5.4.0

v5.3.1

v5.3.0

v5.2.0

v5.1.1

v5.1.0

v5.0.0

4.0.1

4.0.0

3.1.0

v3.0.2

v3.0.1

v3.0.0

v2.5.1

v2.5.0

v2.4.1

v2.4.0

v2.3.0

v2.2.0

v2.1.0

v2.0.1

v2.0.0

v1.18.0

v1.17.1

v1.17.0

v1.16.1

v1.16.0

v1.15.1

v1.15.0

Labels

No items

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

adam (Adam Wojcieszonek)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: adam/vscode-front-matter#771