Passports

Passport Operations

The Product Passports module is the operational hub for managing issued Digital Product Passports. From here, brand administrators can view every passport issued under their brand, inspect individual passport records, apply governance amendments, and manage lifecycle transitions.

Passport List

The passport list displays all issued passports for the active brand in a searchable, filterable table.

ColumnDescription
Passport IDThe unique UUID identifying the passport record. Displayed in full with click-to-copy.
ProductThe product name associated with the passport.
SKUThe product SKU at the time of issuance.
StateThe current lifecycle state: Draft, Published, or Revoked.
IdentifierThe serial number (for serial-mode passports), lot code (for batch-mode passports), or an em dash if neither is present.

Filtering

The list supports server-side filtering by:

  • SKU — filter by product SKU
  • Lifecycle state — filter by Draft, Published, or Revoked
  • Passport ID — search by specific passport UUID
  • Mint type — filter by serial or batch identity mode
  • Batch ID — filter by mint batch UUID

Pagination is cursor-based, supporting efficient navigation through large passport populations.

Bulk Actions

You can select multiple passports to access bulk governance operations via the Action Preflight Bar:

  • Publish — transition eligible passports from Draft to Published
  • Revoke — transition eligible passports from Published to Revoked
  • Controlled Update — apply a field-level correction to eligible passports
  • Break-Glass — apply an exceptional amendment to eligible passports

The preflight bar displays eligible and impacted counts before execution, so you can verify the scope of the action before proceeding.

Passport Detail

Opening a passport reveals its full inspection record. The detail page has a persistent header showing key indicators, followed by a 4-tab inspection area.

Header Indicators

The header displays:

  • Lifecycle state badge — Draft, Published, or Revoked
  • Passport ID — full UUID with click-to-copy
  • Mint Token Batch ID — the mint batch this passport belongs to
  • Mint Unit ID — the specific unit (for serial-mode passports)
  • Created — when the passport was issued
  • Published — when it was published (if applicable)
  • Revoked — when it was revoked (if applicable)
  • Last updated — most recent modification timestamp
  • Live URL — the public resolver URL for this passport
  • Product image — if available
  • QR code — scannable code linking to the passport’s public URL
  • Passport version — the template/publication version

Governance Actions

From the detail page, authorised administrators can:

  • Publish — transition the passport from Draft to Published
  • Revoke — transition the passport from Published to Revoked
  • Controlled Update — apply a targeted field correction
  • Break-Glass — apply an exceptional amendment with mandatory justification

Each action respects role-based access controls and requires the appropriate permission.

Inspection Tabs

The detail page provides four inspection tabs:

Overview

The Overview tab presents the complete passport data in a structured, two-column layout:

Left column:

  • Product Identity — SKU, GTIN, HS Code, commercial status, traceability mode
  • Lifecycle & Minting — state, timestamps, mint batch/unit IDs, identity mode
  • Production Batch & Lot Attributes — batch number, manufacture date, expiry date, lot code, and governed batch-level fields
  • Active Controlled Overrides — any field values that have been amended via Controlled Update or Break-Glass
  • First half of governed attribute sections

Right column:

  • Remaining governed attribute sections

Governed attributes are organised into up to 15 sections driven by the DPP Field Catalogue, including Product Information, Commerce & Variant, Materials & Substances, Environmental Performance, Manufacturer & Origin, and others. Empty sections display a placeholder rather than being hidden, ensuring the full data model is always visible for operational inspection.

Compliance View

The Compliance View mirrors the Overview’s full data display but adds governance and audit detail:

  • All passport data — the same identity, lifecycle, and attribute sections as Overview
  • Governance Change Log — a unified, chronological timeline of all Controlled Update and Break-Glass amendments applied to this passport

Each change log entry shows:

  • the amendment type (Controlled Update or Break-Glass)
  • the field that was changed
  • old and new values
  • the actor who made the change
  • the timestamp
  • the reason or justification provided

Access to the Compliance View requires the passports.view_governance_log permission.

Consumer View

The Consumer View renders a preview of what the end consumer would see when scanning the product. This uses the brand’s configured theme and visual identity to display the passport content as it would appear on the public passport page.

This allows brand teams to verify the consumer experience without needing to scan the physical product.

Machine Readable

The Machine Readable tab displays a valid JSON-LD representation of the passport data using the Schema.org Product vocabulary with Digital Product Passport extensions.

The JSON-LD document includes:

  • product identity (name, SKU, GTIN)
  • lifecycle state and timestamps
  • all governed product attributes as additionalProperty entries
  • controlled overrides merged into the attribute values
  • minting metadata (identity mode, batch ID, serial, lot code)
  • the passport’s live resolver URL

A Download JSON button allows the document to be exported as a .jsonld file for integration with external systems or regulatory submissions.