Modeling Content

Design semantic content models by selecting the appropriate canonical block type (Standalone, Collection, Configuration, or Auto-Blocked), structuring data with clear columns and rows (max four cells per row), and ensuring author-friendly labeling. This approach produces intuitive authoring surfaces and reduces decoration code complexity.

Author-friendly models use semantic formatting, predictable field organization, and reusable patterns that match how content creators think about the block's purpose. Clear column naming and logical grouping prevent inconsistent content and reduce authoring frustration.

Refactor when creating new blocks, modifying existing blocks that change authoring structure, migrating content between systems, or when current models deviate from semantic design principles. Validation against best practices identifies opportunities to improve consistency and author experience.

No. Each canonical block model (Standalone, Collection, Configuration, Auto-Blocked) serves different use cases and authoring patterns. Choosing the right model for your block's purpose ensures the content structure aligns with how authors will interact with and manage content.

Content models must enforce a maximum of four cells per row in table structures. This constraint ensures readable authoring interfaces and consistent rendering across blocks while maintaining semantic clarity in the underlying data.

Use the best practice checklist to confirm your model is semantic, predictable, reusable, and author-friendly. Validation ensures consistency with CDD workflows and catches potential decoration code complexity before blocks are deployed.