Skip to content
See Sanity in action 👀 Join us for a live product demo + Q&A →
Sanity
Get started
  • Sanity Studio - Flexible editing environment
  • Content Lake - Real-time database
  • Developer experience - Tooling you love
  • Structured content - The philosophy behind Sanity
  • Review changes - View edits & rollback instantly
  • Image pipeline - On-demand transformations
  • E-commerce - Better shopping experiences
  • Marketing sites - Control your story
  • Products & services - Innovate and automate
  • Mobile apps - Content backend for every OS
  • Aether - Unique digital shopping experience
  • Morning Brew - Omnichannel media distribution
  • InVision - Delivering exceptional customer experiences
  • DataStax - Personalization for global audience
  • React
  • Gatsby
  • Next
  • Nuxt
  • Eleventy
  • Netlify
  • Vercel
  • Algolia
  • Documentation
  • Reference
  • Guides
  • Resource library
  • Headless CMS
  • Tools & plugins
  • Project showcase
  • Schemas & snippets
  • Agency partners
  • Technology partners
  • Get support
  • Share your work
  • 5 Disadvantages Of Wordpress That Are Holding You Back
EnterprisePricing
Contact salesLog inGet started
Published August 6th 2020

Why content modeling early unlocks value

Content modeling early in the lifecycle of a project is really valuable. Learn how to apply it to projects young and old, tricks for modeling with legacy software, and advice for considering CMS migrations.

Ronald Aveling

Ronald works with content for Sanity.io

Knut Melvær

Principal Developer Marketing Manager

TLDR: We think you should introduce content modeling as early as possible because it unlocks what is frequently known as the content-first approach.

Need help modeling for existing projects? Take this shortcut.

Protip

This article is an aside to our series on content modeling. To learn more about content modeling with Sanity.io checkout our guides.

Content supports intent

This needs to be said early because it can be easy to overlook: in the vast majority of cases your audience is there for your content. More specifically, the content that unlocks their goals.

Whether it’s reading your restaurant menu, scheduling a massage appointment, or ordering a spare part – it’s usually your content that drives user intent. The quality of that content and the ease with which your audience can use it are often most important to them.

Content without structure is risky

On the flip side – too much content, or presenting the wrong content for a situation can sour your audience’s experience. Being unclear about content structure can lead to unnecessary risks and potentially a large opportunity cost.

Working from a presentation-first mindset can produce inferior content outcomes

For a long time the most common way to manage digital projects involved a presentation-first approach. These projects usually start off with a handful of quick assumptions about the shape and use of content.

While it’s often intuitive to envision the shapes and visual designs first, this strategy can produce inferior content outcomes. The reasons are many, but here are a few:

  • When content creation starts late, it becomes a rush job.
  • The initial presentation doesn’t support the content’s final shape.
  • When the real content finally lands, it causes additional design and coding work.

In the end your content won’t live up to its fullest potential.

In most cases, your project depends more on the value that your content offers, than the manner in which it is presented. So, model early to understand what your content will really look like, and let the presentation amplify (rather than constrain) what you say and do.

Tweet by:Actually,'s photo
Actually,
@eaton

Think of your content model as a restaurant menu. The challenge isn't in producing a piece of fancy paper with dishes on it — it's in planning the combination of dishes your customers will love, your team can produce consistently, and your business can source profitably.

Tweet published on: Oct 16, 2019, 3:05 PM
Liked by: 186
Replied by: 12

Content modeling helps you understand your domain better

The process of modeling content gives you a better understanding of your subject domain. So, it’s highly likely that the process will evolve the way you think about your audience, operations, and the details of the project you’re working on.

It's common to come away from a modeling exercise with a more defined sense of your project’s scope and priorities. If you model early you’ll have better pathways to achieving more with the time and resources you have.

Content modeling can help you agree on words

It’s really helpful to be able to label your content and data entities according to the terms and phrases that are native to your domain and audience. Once your entities relate to your subject domain they become more intuitive to work with, and can make content editing, documentation, and onboarding processes more efficient. Learn more about the importance of building a common vocabulary.

Writers get writing

If you complete the modeling process early – you not only set up a great framework for efficient design and development work, you also unlock your content people early on. They can use the added time to improve the quality of their content to better serve the meaning and value your users are there for. You might also improve morale by avoiding the last-minute content rush that comes with presentation-first, and often eventuates in undercooked and ill-fitting materials.

Protip

With Sanity you can setup a cloud-hosted content model with a real-time editing interface in minutes. Use it to prototype and stress test the kind of content you want, or get your authors started with production-ready content from day one.

Designers get to work with real content

A pre-established content model and an active content team make interface designing easier. Designers get to build the presentation layer with real content. The presence of real content also lets them stress test interfaces to accommodate content variation.

Tweet by:Carrie Hane's photo
Carrie Hane
@carriehd

Static HTML site. 8 weeks from start to finish, including setting strategy for extensibility and scalability. If all are committed, doing content early will shave 1-2 weeks off. Designer needs content to design. Client needs content to approve. w/o content, we'll work in circles.

Tweet published on: Aug 3, 2020, 2:28 PM
Liked by: 63
Replied by: 2

What about existing projects?

The Amiga 500 personal computer system. Hopefully your content doesn't go that far back. (photo © Bill Bertram 2006, CC-BY-2.5)

If you’re working with an existing body of content and find that you’re investing a lot of time repeating tasks, or manually distributing content to various channels – then your content could probably do with some revision.

Here are a few situations where you may want to stop what you’re doing, and complete a modeling exercise to avoid repeating the problems of the past:

Before a redesign

If you’re renovating the way your content is presented and find that your new layout ideas are inhibited by the structure that you already have in place – it’s time to remodel!

In this scenario your existing structure may be too closely coupled to the presentation concerns of your last redesign. This is a common pitfall, especially when using page builders. Baking presentation concerns into the core of your content structure may seem like a great idea in the moment, but the trade off is content durability. You’re always better off building your content structure around the essentials.

If you must include presentation needs, make them disposable

In a perfect world we build structured content that can go anywhere and do anything.

However, in the real world we can’t always achieve the ideal, and there are plenty of reasons why that may be the case. In these instances, don’t let the perfect be the enemy of the good, just do your best given the situation that you find yourself in.

If you do need to include presentation concerns in your content model, see if you can incorporate them in such a way that they can be taken away without compromising the essential meaning and value of your content.

// pet.js

export default {
  title: 'Pet',
  name: 'pet',
  type: 'document',
  fields: [
    {
      title: 'Name',
      name: 'name',
      type: 'string',
    },
    {
      name: 'image',
      type: 'image',
      title: 'Image',
      options: {
        hotspot: true,
      },
      fields: [
        {
          name: 'alt',
          type: 'string',
          title: 'Alternative text'
        }
      ]
    },
    {
      title: 'Species',
      name: 'species',
      type: 'string',
    },
    {
      title: 'Special ability',
      name: 'specialAbility',
      type: 'text',
    },
    {
      // A presentation-related field
      // separate from the others
      // if you remove this because you don't need it later on
      // all other fields will be unaffected 
      title: 'Display Theme',
      name: 'displayTheme',
      type: 'string',
      options: {
        list: [
          {value: 'dark', title: 'Dark'},
          {value: 'light', title: 'Light'},
          {value: 'brand', title: 'Brand'},
        ]
      }
    }
  ]
}

Before opening a new distribution channel

If you’re rolling out a new content service or product to reach audiences in other channels, then you should consider the modeling process as a means to essentialize your key needs and model to them.

When you have content isolated in different silos it makes it harder to manage and extract value from. A good content platform should enable multichannel distribution from a single content source of truth.

Before switching to a new CMS

If you’re considering switching from one Content Management System (CMS) to another we highly recommend that you undertake a modeling exercise beforehand.

With a content model in hand you’ll be better equipped to compare the various CMS features against your core needs. If you haven’t figured your model out in advance you may find yourself thinking about structure through the opinionated lens of your last CMS. This can lead to repeating the problems of the past.

Gotcha

Don’t make the modeling exercise about a CMS to CMS transition.

While it may seem like a good idea to make CMS migration concerns a core criteria, it can add undue bias and diminishes outcomes. Support your long-term interests by prioritising your domain and the goals of your audience above CMS related concerns.

Protip

Find a CMS without hard opinions

A good CMS will let you structure content the way you need, not the way they think you need it. A good CMS will provide a blank canvas, and flexible modeling to create structures that will support the most user value, meaning and durability over time.

We think Sanity solves this problem 🤓

Before adding new content tools to what you have

If you have content living in legacy software that you can’t abandon, there’s no reason why you can’t improve its reach and value by connecting it to a platform like Sanity.

In this particular case, the necessity of your legacy software should have some influence on the modeling process itself. Your new platform should be capable of enveloping your legacy content so that it can be enhanced to align more closely with core needs.

Summary

Adopting content modeling early on in a project lifecycle can improve the workflow and output of writers and designers, and contributes to better user experience by way of having content that is structured around domain logic and audience needs.

Protip

To kickstart your own content modeling exercise check out our guide for getting started.

Page content

  • Content supports intent
  • Content without structure is risky
  • Working from a presentation-first mindset can produce inferior content outcomes
  • Content modeling helps you understand your domain better
  • Content modeling can help you agree on words
  • Writers get writing
  • Designers get to work with real content
  • What about existing projects?
    • Before a redesign
    • Before opening a new distribution channel
    • Before switching to a new CMS
    • Before adding new content tools to what you have
  • Summary

Platform

Structured ContentDeveloper experienceContent LakeSanity StudioSecurity & Compliance
  • Sanity vs Contentful
  • Sanity vs Strapi
  • Sanity vs Wordpress
  • Sanity vs Adobe Experience Manager
  • Sanity vs Hygraph
  • Sanity vs Sitecore
  • Sanity vs Storyblok
  • Sanity vs Contentstack
  • Sanity vs Prismic
  • Sanity vs Drupal
  • Sanity vs ButterCMS

Resources

Documentation
  • React Blog
  • Gatsby Blog
  • Next.js Landing Pages
  • Progressive Web Application
  • Single Page Application
  • Svelte & Typescript App
  • Vue & Tailwind Blog
  • Developer Portfolio Templates
  • Form validation with Yup
  • Live Preview with Next.js and Sanity.io
Resource library
  • Agency partners
  • Technology partners
  • Blog Template
  • Personal Website Template
  • Developer Portfolio Templates
  • All Templates
Case Studies
  • Headless CMS
  • What is an API CMS
  • Static Sites 101
  • Headless SEO
  • Localization
  • GraphQL vs REST
  • What is a DXP?
  • Typescript 101
  • Content as a Service
  • Ecommerce SEO
  • React CMS
  • Next.JS CMS
  • CMS for Shopify
  • Content platform
  • Multilingual CMS
  • Static Site CMS
  • Gatsby CMS
  • Node CMS
  • E-commerce CMS
  • Vue CMS
  • Angular CMS
  • GraphQL CMS
  • Newspaper CMS
  • Magazine CMS
  • CMS for apps
  • Remix CMS

Company

Contact SalesEnterpriseCareersTerms of ServiceAccessibility Statement

Stay connected

  • GitHub
  • Slack
  • Twitter
  • YouTube
  • Stack Overflow
  • Blog RSS
  • Newsletter
©Sanity 2023