Global Search

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.


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.


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.


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