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
  • Resolver and Passport Rendering
  • The Scan URL
  • What Happens on Scan
  • The Passport Page
  • Why Two URLs?
  • Domain Support
  • Platform Subdomains
  • Custom Hostnames
  • FAQ
  • Related
Domains & Custom Hostnames

Resolver and Passport Rendering

Was this page helpful?
Previous

Custom Hostname Lifecycle

Next
Built with

Resolver and Passport Rendering

When a consumer scans a QR code on a product, two URLs are involved in the experience:

  1. The scan URL — a GS1-compatible resolver path encoded in the QR code
  2. The passport page — the rendered Digital Product Passport the consumer sees

This page explains how these two URLs relate and why this architecture is used.

The Scan URL

The URL encoded in a QR code, NFC tag, or RFID payload follows the GS1 Digital Link standard:

https://brand.tieback.io/01/09506000123456
https://passport.brand.com/01/09506000123456/21/ABC123

This URL identifies the product using internationally recognised identifiers:

  • /01/<GTIN> — Global Trade Item Number
  • /10/<lot> — Batch or lot number (optional)
  • /21/<serial> — Serial number (optional)

The scan URL is the standards-compatible entry point. It ensures interoperability with GS1 systems and regulatory frameworks such as the EU Digital Product Passport.

What Happens on Scan

When the scan URL is accessed:

  1. The resolver validates the identifier against the brand’s product catalogue
  2. The resolver determines the correct passport destination
  3. The consumer is redirected (HTTP 302) to the passport page

This redirect is transparent — the consumer sees the passport page load directly.

The Passport Page

The rendered passport page uses a canonical application path:

https://brand.tieback.io/p/<passport-id>
https://passport.brand.com/p/<passport-id>

This is the page where the consumer views the full Digital Product Passport, including product details, sustainability data, and provenance information.

The passport page URL is the rendering destination, not the identifier. The QR code always encodes the GS1-compatible resolver path, not the passport page path.

Why Two URLs?

BenefitDetail
Standards compatibilityThe scan URL follows GS1 Digital Link conventions for interoperability
Clean presentationThe passport page is optimised for consumer viewing
Stable deliveryThe passport page URL remains stable even if identifiers change
FlexibilityThe resolver can route to different passport experiences without changing printed QR codes

Domain Support

tieback supports both platform subdomains and custom hostnames for the full scan-to-passport flow:

Platform Subdomains

Every brand receives a subdomain automatically:

https://brand.tieback.io/01/09506000123456
→ redirects to https://brand.tieback.io/p/<passport-id>

Custom Hostnames

Brands can configure a custom hostname for a branded experience:

https://passport.brand.com/01/09506000123456
→ redirects to https://passport.brand.com/p/<passport-id>

Custom hostnames require a DNS CNAME to the brand’s platform subdomain. See the DNS Setup Guide for instructions.

FAQ

Why does the QR code not link directly to the passport page?

The QR code encodes a GS1-compatible resolver URL that follows international identification standards. The resolver validates the identifier and redirects to the passport page. This ensures the QR code remains standards-compliant while the passport page can be optimised for presentation.

Is this still GS1-compatible?

Yes. GS1 Digital Link compatibility is defined by the scan URL — the URL encoded in the QR code. That URL follows the GS1 Digital Link URI standard. The destination page after redirect is outside the scope of the specification.

Can I use my own domain?

Yes. tieback supports custom hostnames such as passport.brand.com. Once the DNS CNAME is configured and the hostname is verified, the custom domain serves the full resolver and passport flow.

What if my custom domain is not active yet?

The platform subdomain (brand.tieback.io) remains available at all times. You can use it while your custom hostname is being verified.

Does the redirect slow down the experience?

No. The redirect is a single HTTP 302 response, typically completed in under 100ms. The passport page loads immediately after.

Related

  • Domain Architecture
  • Resolver Domain Flow
  • DNS Setup Guide
  • Resolver & GS1 Digital Link