The engineer's guide to content operations [E-commerce edition]

Written by John Siciliano

Why can some teams launch global campaigns in minutes (đź‘‹ Tecovas) while yours is still waiting on a homepage swap?

Hint: It’s not their CMS. It’s their architecture.

The best teams don’t scale by adding headcount or hacking together workflows.

They build systems around their team and operations.

Not a custom CMS, but a stack built on structured content, developer primitives, and programmable workflows.

Fully customizable. Minimal maintenance. Built to scale.

Why now? Delay has real costs.

Commerce teams are creating more content for more surfaces with smaller teams and higher expectations. But most systems were built for publishing, not operations.

AI can't work without structured, queryable content. New surfaces mean more duplication without reuse. Each workaround adds technical debt, and replatforming becomes inevitable.

Sanity gives you the infrastructure to move faster and adapt to whatever comes next. Structured content, programmable workflows, and automation-ready architecture built for scale.

This guide shows the architecture, code snippets, and workflows behind high-velocity, scaling e-commerce teams.

The brands you'll see:

But first, what’s everyone dealing with right now?

PortableText [components.type] is missing "gatedContent"

The current state of e‑commerce content ops

E-commerce teams are under pressure to move faster with less.

Customers expect personalized, localized, story-driven experiences across every channel. But most content systems still assume you're shipping static pages, not orchestrating real-time campaigns. AI, automation, and structured content are now table stakes.

Here’s what we’re seeing:

The most forward-looking teams are rethinking how content gets planned, modeled, and delivered, not just how it gets displayed.

Why e‑commerce teams hit a wall

The commerce platform doesn’t matter as much as it used to. They can all sell a product online, whether it’s Shopify, Magento, SFCC, BigCommerce, or Commerce Tools. The real challenge is everything that happens around the product: localized campaigns, seasonal storytelling, personalized promotions, and managing all of it across markets without scaling your team.

Here’s where content operations start to break down:

The shift doesn’t happen because someone wants a shinier CMS. It happens when the cost of doing things the old way gets too high. What starts as fixing one pain point becomes an opportunity to rethink how content moves through your organization—not just how it’s stored or displayed but also how it’s modeled, governed, reused, and orchestrated. I.e., how companies can leverage a Content Operating System.

What is a "Content Operating System"?

You’re already running a content system (even if you didn’t mean to).

It’s the spreadsheets, Slack threads, and last-minute dev requests that hold everything together. Launching a sale means chasing down banners, image variants, and approvals and duplicating those efforts across markets.

A Content Operating System replaces that with actual infrastructure: structured content, developer tooling, and workflows that match how your team operates, not just how content looks but also how it moves.

This guide shows our customers’ architectures in five stages of content operations:

  1. Plan and govern – Model complex product data, evolve without rewrites, and enforce smart rules that guide editors without blocking them.
  2. Create and manage – Build editing tools that fit your teams’ exact workflows, from full-featured CMSes to single-purpose custom apps.
  3. Distribute and automate – Efficiently launch campaigns across languages, regions, and surfaces.
  4. Analyze and optimize – Link content variants to conversion data, run experiments, and personalize without ballooning scope.
  5. Extend and integrate – Connect to your stack (PIM, ERP, DAM, storefront) with real-time sync and zero infrastructure headaches.

The Content Operating System is built to be shaped. It includes editors, workflows, and data models. Every part is customizable to match how your team works.

This guide shows how engineers at brands like Tecovas, SKIMS, and Lady Gaga moved from managing content to orchestrating it. It’s not about switching CMSes. It’s about building systems that scale with your business.

1. Planning and governing: Architecting your "foundation"

In this section, we'll explore:

The perfect foundation trap

Starting from a blank slate feels like the best opportunity to get it right this time. No more duplicated efforts per market. Let's finally fix our wonky colorways and structure of variants.

Of course, you want to learn from and fix the shortcomings of your current system. However, even if you design the perfect model today, it will slowly calcify as your business evolves (e.g., new product types, seasonal campaigns, unexpected market requirements, etc.).

Most companies are forced into an impossible choice:

What if your foundation wasn't fixed in concrete but could adapt organically as your needs change? Let's learn how your competition keeps shipping while your developers are stuck maintaining increasingly complex workarounds, and editors spend too much time on manual processes.

Make it work → Make it right → Make it fast

With Sanity, you can follow the classic dev mantra: make it work, make it right, make it fast. Start by shipping something that works. See how it performs. Then refactor and optimize once you understand what’s needed.

These are the technical features unique to Sanity's infrastructure that make this possible:

This is why “foundation” is in quotes. Sanity doesn’t treat your architecture as a rigid, fixed system. As you learn what works and what doesn't, you can adapt your content system. Thanks, developer tooling.

While the definition of "perfect" will change, let's explore how Tecovas models the trickiest parts of e-commerce.

How Tecovas solved the products, colorways, and variants architecture

E-commerce data is highly relational. So, this begs the question: How do we model our data to enable maximum reuse and flexibility for those edge cases?

Tecovas needed a product model that separated core product information from color-specific details while abstracting away variant complexity. This would enable them to define global product information once and optionally add specific information to colorways, such as care guides.

Before we look at Tecovas, let's look at a simple schema type to ease us into a more complex one:

Internal server error