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
  • Lifecycle States
  • What Resolves Where
  • Re-Validation
  • Removal
  • Related Docs
Domains & Custom Hostnames

Custom Hostname Lifecycle

Was this page helpful?
Previous

Custom Hostname Troubleshooting

Next
Built with

A custom hostname (for example, passport.brand.com) progresses through a defined lifecycle inside tieback. This page documents the states and what they mean operationally.

Lifecycle States

StateMeaningNext action
RequestedThe brand has registered the hostname in the workspace; DNS records have been issuedAdd the displayed CNAME / TXT records to your DNS
Pending VerificationDNS records are being polledWait — typically minutes to hours
VerifiedHostname ownership is confirmedCertificate issuance begins automatically
Certificate IssuedTLS certificate is provisioned and activeHostname is live for resolver traffic
ActiveLive and serving passport trafficNone — operational
FailingPeriodic re-validation has failedRe-check DNS; the dashboard surfaces the failing check
RemovedThe brand has removed the hostnameCustom URLs revert to the default subdomain

What Resolves Where

  • The dashboard is always served from the platform subdomain — custom hostnames do not expose the dashboard
  • The resolver serves passport traffic at both the platform subdomain and any verified custom hostname
  • Non-resolver app paths on a custom hostname return 403 Forbidden by design — see the custom domain restrictions policy

Re-Validation

Verified hostnames are periodically re-validated. If DNS or certificate health degrades, the hostname transitions to Failing and the workspace receives a notification. Resolver traffic continues to serve from the platform subdomain so passports remain reachable.

Removal

Removing a custom hostname is immediate. Subsequent traffic to the removed hostname stops resolving via tieback. Existing passport URLs minted under that hostname continue to function only if DNS is repointed back; otherwise consumers should be migrated to the platform subdomain URL.

Related Docs

  • Domain Architecture
  • Custom Hostname Setup
  • DNS Setup Guide
  • Troubleshooting