Introducing the Glossary

We just took the wraps off a new learning resource: the Glossary! It’s packed with over 170 terms, and we’re adding more every week.

What was once an internal Notion database for tracking blind spots in our learning materials is now a deep pool of Craft and Craft-adjacent concepts. You can browse the glossary alphabetically, or discover nearby terms via dedicated search (as well as the global search modal, which has received some updates).

Each term has a concise, thoroughly interlinked definition, explicit connections to pages in the documentation, and a list of related knowledge base articles.

Next Steps (and an API!)

In the coming weeks, you’ll start seeing special links throughout craftcms.com (like this one, powered by reference tags), the documentation, and (eventually!) the Craft control panel itself.

These tooltips are powered by a simple JSON API:

fetch('https://craftcms.com/api/glossary/entry-type')
  .then(r => r.json())
  .then(console.log);

// -> { "id": 1234, "title": "Entry Type", ... }

Prepend any term’s public URI with /api to grab plain-text and HTML summaries, or fetch everything at once:

https://craftcms.com/api/glossary

The bulk endpoint also supports a ?query=... param to filter and rank terms by search keywords. Here’s the full schema for an individual term:

{
    "id": 916372,
    "title": "Entry Type",
    "url": "https://craftcms.com/glossary/entry-type",
    "uri": "glossary/entry-type",
    "slug": "entry-type",
    "type": "Term",
    "apiUrl": "https://craftcms.com/api/glossary/entry-type",
    "summaryPlain": "Globally-configured content types that can be selected from sections, Matrix fields, and CKEditor fields. Entries’ field layouts are defined via enrtry types.",
    "summaryHtml": "<p>Globally-configured content types that can be selected from <a href=\"https://craftcms.com/glossary/section\">sections</a>, <a href=\"https://craftcms.com/glossary/matrix\">Matrix</a> fields, and <a href=\"https://craftcms.com/glossary/ckeditor\">CKEditor</a> fields. <a href=\"https://craftcms.com/glossary/entry\">Entries</a>’ <a href=\"https://craftcms.com/glossary/field-layout\">field layouts</a> are defined via enrtry types.</p>",
    "docsLinks": [
        {
            "title": "Entries",
            "url": "https://craftcms.com/docs/5.x/reference/element-types/entries"
        }
    ]
}

Let us know if you’d like to integrate the glossary into your own tooling!