> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://tieback.io/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://tieback.io/docs/_mcp/server.

# Content & Templates

> How brands configure what information appears in their Digital Product Passports using configurable content blocks and the Passport Configurator.

Digital Product Passports in **tie*back*** separate **what information is included** from **how it is presented**. This page explains the content configuration side, how brands control which product data appears in the passport and how localised content supplements it.

## The Passport Configurator

The Passport Configurator is the primary tool for managing passport content. It provides a visual, block-based editor where brands define the structure and content of their Digital Product Passports.

The Configurator is built around **content blocks**: modular sections of information that together form the complete passport experience. Each block represents a category of product information, and brands have full control over which blocks are included, what fields appear within them, and how they are ordered.

### Content Blocks

| Content block                  | What it governs                                                               |
| ------------------------------ | ----------------------------------------------------------------------------- |
| **Product identity**           | Product name, images, key identifiers, and descriptive information            |
| **Materials & composition**    | Raw materials, fibre composition, recycled content, and material declarations |
| **Provenance & manufacturing** | Country of origin, manufacturing location, and supply chain information       |
| **Care & use**                 | Care instructions, repair availability, reuse guidance, and spare parts       |
| **Sustainability**             | Environmental impact data, carbon and water footprint, end-of-life guidance   |
| **Trust & compliance**         | Certifications, compliance declarations, restricted substances, and warranty  |

Each block can be independently enabled or disabled. Within each block, the set of included fields is explicitly defined. Only data for included fields appears in the rendered passport; everything else is excluded, regardless of whether the underlying product record contains it.

### How the Configurator Works

#### Select content blocks

Choose which categories of product information to include in your passport. Enable or disable
entire blocks based on your disclosure strategy and regulatory requirements.

#### Configure fields

Within each enabled block, review and confirm which individual fields appear. Fields can be
toggled on or off to match your data readiness and compliance needs.

#### Preview

See exactly how the passport will render with the current configuration, including the brand's
theme and any linked Market Pack content.

#### Publish

Finalise the configuration and make it the active governing template. Published passport
snapshots retain the content structure in effect at the time of publication.

## Template-Governed Rendering

The passport template governs what the consumer sees, not the raw product record.

A product record may contain extensive structured data, covering dozens of fields across multiple categories. The passport template acts as a controlled lens over that data, presenting only the fields that the brand has chosen to include.

This means:

* **Adding data to a product does not automatically expose it** in the passport. The template must explicitly include the relevant fields.
* **Disabling a field in the template removes it from the passport** even if the product record contains a value for that field.
* **Different templates can present different views** of the same product data, supporting different disclosure strategies or regulatory contexts.

## Content and Localisation

When a Market Pack is linked to a passport, localised content is layered on top of the base template configuration:

* **Base content** is governed by the Passport Configurator, the fields, blocks, and structure defined here form the foundation.
* **Custom field values**: any brand-specific [custom fields](/product-module/custom-fields) with values set on the product are available in the content pipeline and can be included in the passport.
* **Market-specific content**: such as recycling guidance, disclaimers, and supplementary information, is added by the Market Pack as a supplementary layer.
* **Language and formatting**: dates, numbers, and measurement units are rendered according to the Market Pack's locale rules.

The base template structure is never altered by localisation. Market Packs add to the passport experience; they do not modify the content blocks or field selections defined in the Configurator.

See [Localisations Overview](/localisations/overview) for details on how Market Packs work.

## Template and Product Relationship

In the current model, a brand's published passport template applies to all products under that brand. This provides a consistent disclosure framework across the product catalogue.

> **Note**
>
> Future releases will support more granular template assignment, such as per-product or
> per-category templates, for brands that need different disclosure structures for different product
> lines.

## Content vs Presentation

Templates control **content**: what information is included. They do not control **presentation**: how that information looks visually. Presentation is handled by **themes**, which are covered in [Themes & Presentation](/passports/themes-presentation).

This separation means:

* a brand can update its visual presentation without changing the content structure
* a brand can adjust its disclosure strategy without redesigning the passport layout
* content and design decisions can be made independently

## Related Docs

* [Passports Overview](/passports/overview)
* [Themes & Presentation](/passports/themes-presentation)
* [Localisations Overview](/localisations/overview)
* [Publication Lifecycle](/passports/publication-lifecycle)
* [Brand Setup & Readiness](/passports/brand-setup-readiness)
* [Products](/product-module/products)