content-modeling-best-practices

Original：🇺🇸 English

Translated

General principles for structured content modeling that apply across CMSs, with Sanity-specific guidance. Use when designing content schemas, planning content architecture, or evaluating content reuse strategies.

3installs

Sourcesanity-io/agent-toolkit

Added on2026-02-04

NPX Install

npx skill4agent add sanity-io/agent-toolkit content-modeling-best-practices

SKILL.md Content

View Translation Comparison →

Content Modeling Best Practices

Principles for designing structured content that's flexible, reusable, and maintainable. These concepts apply to any headless CMS but include Sanity-specific implementation notes.

When to Apply

Reference these guidelines when:

Starting a new project and designing the content model
Evaluating whether content should be structured or free-form
Deciding between references and embedded content
Planning for multi-channel content delivery
Refactoring existing content structures

Core Principles

Content is data, not pages — Structure content for meaning, not presentation
Single source of truth — Avoid content duplication
Future-proof — Design for channels that don't exist yet
Editor-centric — Optimize for the people creating content

Resources

See

resources/

for detailed guidance on specific topics:

Separation of content and presentation
Reference vs embedding strategies
Content reuse patterns
Taxonomy and classification