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.
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.
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.