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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
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.
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'},
]
}
}
]
}
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.
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 🤓
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.
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.