For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Getting Started
    • Introduction
    • Getting Started
    • Tia — Operations Assistant
    • Architecture
    • Security Architecture
  • Onboarding & Plans
    • Onboarding Overview
    • Plans & Subscriptions
    • Tia Credits
  • Tenancy & Governance
    • Roles & Members
    • Audit Log
    • Notifications
    • Economic Operators
  • Authoring Studios
    • Content Studio
    • Theme Studio
    • Advanced Studio (Track B)
  • Product Module
    • Products
    • Custom Fields
    • Global Search
    • Identifiers
    • Product Import
    • Bulk Editing
    • Bulk Updates
    • Resolver & GS1 Digital Link
    • GS1 Digital Link Contract
  • Localisations
    • Overview
    • Market Packs
    • Multilingual Content
  • Domains & Custom Hostnames
    • Domain Architecture
    • Resolver Domain Flow
    • Custom Hostname Setup
    • DNS Setup Guide
    • Resolver & Passport Rendering
    • Custom Hostname Lifecycle
    • Troubleshooting
  • Passports
    • Overview
    • Passport Operations
    • Lifecycle States
    • Controlled Update & Break-Glass
    • Content & Templates
    • Themes & Presentation
    • Consumer Experience
    • Publication Lifecycle
    • Brand Setup & Readiness
    • Drafts
  • Passport Intelligence
    • Passport Intelligence
    • Intelligence Overview
    • Scan Visibility
    • Trust Signals
    • Engagement Insights
    • Investigation Timelines
    • Data & Privacy
    • Roadmap
  • Minting
    • Overview
    • Lifecycle
    • Architecture
    • Limits & Performance
    • Token Preview
    • Exports & Print Jobs
    • Carrier Output Profiles
    • Bring-Your-Own Serials
    • Security
    • FAQ
  • API Reference
    • API Credentials Guide
    • API: Credentials
    • API: Products
    • API: Identifiers
    • API: Import
    • API: Batches
    • API: Attachments
    • API: Bulk Updates
    • API: Minting
    • API: Resolver
    • API: Search
On this page
  • States
  • State Transitions
  • Who Can Transition
  • Initial State
  • Publication Audit Stamp
  • Revocation Scope
  • Related Docs
Passports

Lifecycle States

Was this page helpful?
Previous

Controlled Update & Break-Glass

Next
Built with

Every Digital Product Passport in tieback has a lifecycle state that determines its visibility, editability, and available governance actions.

States

StateLabel in UIVisibilityGovernance actions available
unpublishedDraftBrand team onlyPublish
publishedPublishedPublic (via scan or link)Revoke, Controlled Update, Break-Glass
revokedRevokedNo longer publicly servedBreak-Glass only

State Transitions

Passports follow a forward-only progression:

Draft → Published → Revoked
TransitionDescription
PublishMakes the passport publicly accessible. The resolver begins serving this passport when consumers scan the product. A publication audit stamp is recorded, linking the passport to the active publication/template version at the time of publishing.
RevokeRemoves the passport from public access. The passport is no longer served by the resolver. Revocation applies to the digital passport object only — it does not cascade to physical carriers, unit identity, or token validity.

Transitions are irreversible: a published passport cannot be returned to Draft, and a revoked passport cannot be republished.

Who Can Transition

Lifecycle transitions require administrator-level permissions and are validated server-side via the transition_passport_lifecycle RPC, which enforces role checks and valid state progression.

Initial State

A passport’s initial state is determined at mint time. When a mint job completes, the resulting passport records are created in the unpublished (Draft) state.

Publication Audit Stamp

When a passport is published, tieback resolves the currently active publication through the passport assignment hierarchy and stamps that publication ID into the passport record. This creates a permanent audit record of which template/content version was in effect at the moment of publication.

This audit stamp is separate from the live resolver routing, which continues to use the dynamic assignment hierarchy to determine which passport to serve.

Revocation Scope

Revocation is strictly scoped to the digital passport object:

  • the passport is no longer served by the resolver
  • the passport record and its full history are retained
  • physical carriers (QR codes, NFC tags, RFID) are unaffected
  • mint unit identity and token validity are unaffected
  • Break-Glass amendments can still be applied to revoked passports

Related Docs

  • Passport Operations
  • Controlled Update & Break-Glass
  • Publication Lifecycle
  • Brand Setup & Readiness