Content Modeling Best Practices

Structured content modeling principles for headless CMS (Sanity, Strapi, Contentful).

Guides the design of structured, reusable content models in headless CMS platforms like Sanity, Strapi, and Contentful, separating content from presentation so the same data can serve web, mobile, and email. It turns ad-hoc page-based schemas into clean, future-proof models with proper references, validation, and editor-friendly fields.

$15 one-time
Add to a kit →

Prices include 20% VAT. · Forged on real agency work · one-time, no lock-in

  • Type Skill
  • Category Content & Video
  • Delivery Email · instant
  • License One-time
Run preview
forgehouse, content-modeling-best-practices

Inside the run · no black box

See the actual work before you buy it.

A schema modeled as pages dies at the first redesign. Modeled as data, with reusable blocks, deliberate references and defensive validations, the same content survives channel changes and migrations untouched.

  1. Models content as data, not pages: instead of a homepage type with locked-in hero and feature sections, it defines reusable block types (hero, features, cta) composed into a generic page via an array, so every block works on any page or channel.
  2. Decides reference versus embedded for every relationship: shared data like an author becomes its own document referenced from posts, so one update propagates to 100 posts instead of being copied into each.
  3. Chooses the taxonomy shape that fits the scope: flat tags, hierarchical categories, or faceted multi-dimensional classification (topic, difficulty, format, duration) when content is filtered along several axes.
  4. Installs the defensive validations: an async slug uniqueness check against the dataset, a required SEO object with character-limited title and description, and an explicit i18n strategy (document-per-locale or field-level translations).
  5. Keeps structure separated from presentation: no className, color or fontSize fields in the schema, only semantic fields, so rendering decisions stay in the frontend layer.
  6. Closes with the verification checklist: every type reusable, no duplication, slugs validated, SEO metadata mandatory, i18n strategy chosen, editor UX optimized with field grouping and preview.
Use cases · what happens when you plug it in

One power source. 6 lines out.

content-modeling-best-practices · core

core active · 6 lines

  1. Designing a content model from scratch for a new headless CMS project

    ✓ designing a content model
  2. Deciding between embedding data and using references

    ✓ deciding between embedding
  3. Choosing flat, hierarchical, or faceted taxonomy for content classification

    ✓ choosing flat, hierarchi…
  4. Refactoring page-coupled schemas into reusable content blocks

    ✓ refactoring page-coupled…
  5. Planning a WordPress-to-Sanity migration schema

    ✓ planning a wordpress-to-…
  6. Adding SEO metadata, slug uniqueness, and i18n strategy to a model

    ✓ adding seo metadata, slug
Benefits · what you walk away with

Yours to keep.

Drag time forward. Watch what stays.

Forever

That's what owning means.

The rented stack

ai writing tool: subscription

expired · access lost

analytics suite: subscription

expired · access lost

design platform: subscription

expired · access lost

(nothing left)

Your forge

  1. Lets one piece of content power multiple channels without duplication

    license: perpetual
  2. Makes site-wide updates instant by changing referenced data in a single place

    license: perpetual
  3. Reduces editor friction with grouped fields, previews, and clear validation messages

    license: perpetual
  4. Avoids costly breaking migrations through a backward-compatible evolution strategy

    license: perpetual

subscriptions expire · deeds don't

What's included · the full manifest

Everything in the box.

Pick a piece up. Watch it work.

Core principles: content-as-data, single source of truth, separation of concerns, editor-centric design

part 01 of 06 · in the box

6 parts · one working system · ships instantly by email

Who it's for

This wasn't forged for everyone.

  • Not for you if you'd rather rent a tool than own one.
  • Not for you if you want someone else to run your stack.
  • Not for you if you're happy guessing.
Still here? Good.

Developers and content architects designing or refactoring headless CMS schemas who want a maintainable, multi-channel foundation.

then this was forged for you.

Works with

Universal by design: these run in any AI. Delivered in the open Agent Skills + MCP format (native in Claude); ChatGPT, Gemini, Cursor and Copilot adapt the same files their own way.

  • Claude Native format
  • ChatGPT Adapts via open standards
  • Gemini Adapts via open standards
  • Cursor Adapts via open standards
  • Copilot Adapts via open standards
Questions · still in the air

Catch what's on your mind.

the air is clear. nothing between you and the forge.
catch a spark: the forge will answer

  1. I am on Contentful. Are the patterns specific to it, or generic theory?

    The modeling principles apply across Sanity, Strapi and Contentful, with references, validation and taxonomy choices that map to each. You get concrete schema decisions, not platform-agnostic theory.

  2. Embed versus reference always turns into 'it depends.' Does it give an actual rule?

    It does, tying the choice to reuse and relationship cardinality, so shared, independently-edited data becomes a reference and tightly-owned data gets embedded. You decide by how the content is used, not by feel.

  3. Will it migrate my existing page-based schema, or only design new models?

    It can turn ad-hoc page-based schemas into clean reusable models, so it covers refactors as well as greenfield design. The thinking is structural, while the field-by-field migration in your CMS stays your build step.

  4. How is it delivered?

    By email right after purchase: ready to run, downloaded instantly, no setup wait.

  5. One-time or subscription?

    A one-time purchase; no subscription or hidden fees. VAT (20%) is included.

  6. Can I get a refund?

    As a digital product, it can’t be refunded once downloaded. That’s why we show exactly what’s inside and who it’s for, right here.