Back to skills

content-modeling-best-practices

docs

Structured guidance for designing content schemas in Sanity and other headless CMSes. Covers when to use references versus embedded objects, how to avoid page-shaped schemas, content reuse patterns, a

Setup & Installation

npx skills add https://github.com/sanity-io/content-modeling-best-practices --skill content-modeling-best-practices
or paste the link and ask your coding assistant to install it
https://github.com/sanity-io/content-modeling-best-practices
View on GitHub

What This Skill Does

Structured guidance for designing content schemas in Sanity and other headless CMSes. Covers when to use references versus embedded objects, how to avoid page-shaped schemas, content reuse patterns, and taxonomy design. Applies to new projects and schema refactors alike. Without explicit modeling guidance, schemas tend to drift toward presentation-driven structures that break when you add a new channel or reuse content in a different context.

When to use it

  • Working with content modeling best practices functionality
  • Implementing content modeling best practices features
  • Debugging content modeling best practices related issues