Managing multiple brands in zeroheight
Learn

Managing multiple brands in zeroheight

Author Avatar
Written by
Jun 23, 2026

Multi-brand design systems solve an architecture problem and a documentation problem simultaneously. The architecture problem — how to express multiple visual identities through a single token system — is covered in Article 07 — Multi-brand, multi-product and white-label token architecture. The documentation problem is what this article addresses: once your multi-brand token system is built, how do you present it in zeroheight in a way that's navigable, governable, and useful to the teams consuming it?

The choices you make here affect who can find what, how quickly new brand teams get up to speed, and how much overhead the system team carries as the number of brands grows.

The first decision: multiple styleguides or one?

The most fundamental documentation question for a multi-brand system is whether each brand gets its own styleguide or whether everything lives in a single shared styleguide.

There's no universal answer, but the decision criteria are fairly clear.

Multiple styleguides

A separate styleguide per brand is the right choice when:

  • Brands have genuinely distinct audiences. A styleguide for Brand A's product teams shouldn't require those teams to navigate Brand B's color palettes, component decisions, and usage guidelines to find what they need.
  • Brands are governed independently. If Brand A and Brand B are managed by separate teams with separate ownership, separate styleguides give each team their own space to document, update, and maintain without affecting the other.
  • Brands diverge significantly. When brands have different components, different design patterns, or different interaction models (not just different colors) a single styleguide with "Brand A version / Brand B version" of everything quickly becomes unwieldy.
  • Access control matters. If some brand documentation should only be visible to specific teams or clients, separate styleguides let you manage permissions independently.

A single multi-brand styleguide

A shared styleguide works best when:

  • The system's shared foundation is the story. If the point of your multi-brand system is that all brands run on the same component library, showing that shared foundation in one place is a feature, not a compromise.
  • Brands are closely related. Sub-brands or product lines within the same parent brand (where the visual differences are in color, typography, and radius rather than structure) are easier to document together than separately.
  • The team is small. A single system team maintaining multiple separate styleguides multiplies the documentation maintenance burden. A shared styleguide with brand-specific sections keeps everything in one place.

In practice, many organizations end up with a hybrid: a shared system-level styleguide covering the shared foundation, plus brand-specific styleguides for the identity and usage guidelines that are unique to each brand. The shared styleguide is the source of truth for "how this system works"; the brand styleguides are the source of truth for "how this brand uses it."

Setting up brand-specific tokens in the Tokens Manager

Whether you're using multiple styleguides or one, brand-specific tokens need to be surfaced correctly in the Tokens Manager.
The cleanest approach follows the token architecture from Article 07: brand tokens live in brand-specific collections that override the shared semantic layer. In zeroheight, all of these collections — shared and brand-specific alike — are consolidated into a single token set in the Tokens Manager, with Collections used to organize them. In the Tokens Manager you'll see something like:

Token set
  Collections
    00 Primitives (shared)
    01 Semantic (shared)
    02 Brand A: Color
    02 Brand B: Color
    02 Brand C: Color


This structure makes it clear which tokens are shared and which are brand-specific, while keeping everything in one place. When Brand B's primary color changes, the update is isolated to Brand B's collection. The shared collections are untouched.
For documentation purposes, brand-specific collections can be surfaced on the appropriate pages of the styleguide using the Design Tokens block. A Brand A color palette page shows Brand A's tokens; a Brand B page shows Brand B's. Neither leaks into the other.

Presenting components across brands

One of the most useful things a multi-brand styleguide can do is show the same component in multiple brand contexts simultaneously. This demonstrates the power of the token system (the same component code, different visual output) and gives consuming teams a reference for what the component should look like in their brand.

In zeroheight, this is achieved by embedding component documentation with brand-specific token modes applied. Design frames can be embedded with different modes active, showing the component in Brand A and Brand B side by side on the same page.

A few patterns that work well:

Side-by-side brand comparison. Show the same component (a button, a card, a form input) in two or three brand contexts next to each other. This is particularly effective for shared component documentation in a single multi-brand styleguide, where the audience includes teams from multiple brands.

Brand-specific component pages. In a multi-styleguide setup, each brand's styleguide shows components in that brand's context only. The shared system styleguide can still show multi-brand comparisons to illustrate how the system works.

Mode-switching in embedded previews. If you're using zeroheight's live component previews, embedding components with different token modes active gives readers a real-time sense of how the component responds to brand switching.

The key discipline: use semantic token references in your components consistently. A component that bypasses the semantic layer and references a primitive directly will look the same regardless of which brand mode is applied, defeating the purpose of the multi-brand demonstration.

Governance across multiple brand styleguides

More brands means more documentation to maintain, more contributors to coordinate, and more opportunities for things to drift out of sync. Governance structures that work for a single-brand system need to scale.

Permissions and ownership

zeroheight's permission model allows you to control who can view and edit each styleguide. In a multi-styleguide setup, this means each brand styleguide can be managed by its own team, with the system team maintaining admin access across all of them for cross-brand governance.

Useful permission patterns for multi-brand setups:

  • System team as admin on all styleguides. The team responsible for the shared foundation needs visibility into all brand styleguides to catch inconsistencies and enforce system-level standards.
  • Brand teams as editors on their own styleguide. Brand designers and developers can maintain their own documentation without needing access to (or the ability to accidentally edit) other brands' styleguides.
  • Stakeholders and consumers as viewers. Marketing teams, external partners, and other stakeholders who need to read the documentation but shouldn't be editing it get view-only access.

Keeping shared content in sync

One of the maintenance challenges in a multi-styleguide setup is keeping shared content (system-level principles, shared component documentation, contribution guidelines) in sync across all styleguides. Updating the same content in five separate styleguides manually is error-prone and time-consuming.

A few approaches to managing this:

  • Designate a system styleguide as the canonical source. Shared content lives here; brand styleguides link to it rather than duplicating it.
  • Use GitHub markdown sync for shared documentation. If your system documentation is maintained as markdown in a repository, zeroheight's GitHub integration lets you sync the same source file to multiple styleguides, keeping shared content consistent without manual duplication.
  • Establish a review cadence. A quarterly pass across all brand styleguides to check that shared sections are still accurate and aligned catches drift before it compounds.

Setup patterns by scale

The right structure depends significantly on how many brands you're managing.

Two to three brands

At this scale, a single shared styleguide with brand-specific sections is often the most practical approach. The overhead of maintaining separate styleguides outweighs the navigational benefit, and the audience for each brand's documentation is small enough that cross-brand content isn't significantly disruptive.

Structure the shared styleguide with a clear top-level section for each brand, and a shared system section covering the foundation. Brand-specific collections are surfaced in the relevant section via Design Tokens blocks.

Four to ten brands

Here the case for separate styleguides strengthens. Navigation in a single styleguide becomes genuinely complex at this scale, and the likelihood that brand teams have distinct audiences and governance needs increases.

A hybrid works well: a system styleguide covering the shared foundation and the multi-brand architecture, plus individual brand styleguides for each brand's specific implementation. The system styleguide acts as the hub; brand styleguides are the spokes.

Twenty or more brands

At this scale, the documentation challenge becomes a platform problem. Manually maintaining twenty separate styleguides, even with good governance, doesn't scale. The most viable approach is generating brand styleguide sections programmatically from the token system, using zeroheight's API to push brand-specific content rather than maintaining it by hand.

For white-label setups where partner brands are the audience, the token exposure model covered in Article 07 determines what each partner can customize. Their styleguide access reflects the scope of their customization — they see only the tokens they control, not the locked system-level values.

What comes next

Article 20 — Token governance workflows in zeroheight closes out the guide with the zeroheight-specific governance tools: analytics for measuring token adoption, changelog setup, access controls for contribution workflows, and how to integrate zeroheight into the token release pipeline.

Author Avatar
Try zeroheight
The design systems platform that keeps teams and agents in sync
Start for free
Share this post