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
  • Overview
  • What You Can Search
  • Products
  • Tokens
  • Batches
  • Exports
  • Smart Query Routing
  • GS1 Digital Link & Resolver URL Lookup
  • Navigating Results
  • Keyboard Shortcuts
  • How It Works
  • Tips for Effective Searching
  • Constraints
Product Module

Global Search

Was this page helpful?
Previous

Product Identifiers in TieBack

Next
Built with

Overview

tieback

Global Search gives you instant, workspace-wide lookup across every object in your account — products, tokens, batches, and exports — from a single search bar.

Open Spotlight Search with ⌘K (Mac) or Ctrl+K (Windows/Linux) from anywhere in the platform. Start typing and results appear immediately, grouped by type and ranked by relevance.


What You Can Search

Global Search covers four core object types across your entire workspace:

Products

Find any product by searching across multiple fields simultaneously:

FieldHow It MatchesExample
Product nameMatches across all configured languagesWinter Gloves, Gants d'hiver
SKUPartial match anywhere in the SKUGL4 finds GL4-123
DescriptionPartial match on product description textorganic cotton
Attribute valuesMatches any product attribute valuesteel grey, china
GTINExact match on 8, 12, 13, or 14-digit identifiers5060999100063

Product search is designed for rich, semantic discovery — you don’t need to remember exact identifiers to find what you’re looking for.

Tokens

Search for individual minted tokens by their serial number. Type at least 4 characters of a serial to find matching tokens.

Example: Searching 13250d12 finds all tokens whose serial starts with that value.

Batches

Search for mint batches by their batch ID. Partial matches are supported from the start of the ID.

Exports

Search for export records by their export ID or export group ID. Paste a full UUID to find the exact export.


Smart Query Routing

Global Search automatically understands what you’re looking for based on your input:

What You TypeWhat’s Searched
Plain text (e.g. winter gloves)Products only
A GTIN (e.g. 5060999100063)Products (exact GTIN match)
A UUIDProducts, batches, and exports
Mixed text and numbers (e.g. GL4-123)Products, tokens, and batches
A GS1 Digital Link URLAutomatically parsed (see below)

You never need to tell the system what type of object you’re searching for — it figures it out from your query.


GS1 Digital Link & Resolver URL Lookup

You can paste a full GS1 Digital Link or resolver URL directly into Global Search. The system automatically extracts the relevant identifiers and finds the matching object.

Token lookup (URL with serial):

https://acme.tieback.io/01/5060999100063/21/13250d12
→ Finds the token with serial "13250d12"

Product lookup (URL with GTIN only):

https://acme.tieback.io/01/5060999100063
→ Finds the product with GTIN "5060999100063"

This is especially useful when you receive a resolver URL from a supply chain partner, a printed QR code, or a scan event — paste it directly into Spotlight to jump straight to the relevant record.


Navigating Results

Results are grouped in a consistent order: Products → Tokens → Batches → Exports.

Each result shows:

  • Primary label — the object name or identifier (e.g. product name, token serial)
  • Secondary label — supporting context (e.g. SKU, batch ID)
  • Status — current object status where applicable

Click a result or press Enter to navigate directly to the object’s detail page:

Result TypeOpens
ProductProduct detail page
TokenToken detail page
BatchBatch detail page
ExportExports view

Use ↑ and ↓ arrow keys to move through results without leaving the keyboard.


Keyboard Shortcuts

ShortcutAction
⌘K / Ctrl+KOpen Spotlight Search
↑ ↓Navigate results
EnterOpen selected result
EscClose Spotlight

How It Works

  • Workspace-scoped — you only see objects that belong to your workspace. Cross-workspace data is never returned.
  • Instant — results appear as you type with built-in debouncing for a smooth experience.
  • Cursor-paginated — large result sets load progressively without performance degradation.
  • Timeout-safe — queries are bounded to prevent slow responses. If a query takes too long, you’ll see a friendly message suggesting you refine your search.

Tips for Effective Searching

  1. Use product names in any language — search matches across all configured locales, not just English.
  2. Paste resolver URLs directly — no need to manually extract GTINs or serials from URLs.
  3. Search by attribute values — if you know a product’s colour, material, or any attribute, you can search by it.
  4. Use at least 4 characters for token serials — shorter queries are too broad to return useful token results.
  5. Paste a full UUID — to find a specific product, batch, or export by its exact ID.

Constraints

RuleDetail
Minimum query length2 characters
Token serial minimum4 characters
ScopeWorkspace-scoped — only your workspace’s objects are returned
PaginationCursor-based for consistent performance at scale