> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://tieback.io/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://tieback.io/docs/_mcp/server. # Global Search > Find any product, token, batch, or export across your workspace with Spotlight Search, including GS1 Digital Link and resolver URL paste lookup. ## Overview **tie*back*** 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: | Field | How It Matches | Example | | -------------------- | ------------------------------------------------- | -------------------------------- | | **Product name** | Matches across all configured languages | `Winter Gloves`, `Gants d'hiver` | | **SKU** | Partial match anywhere in the SKU | `GL4` finds `GL4-123` | | **Description** | Partial match on product description text | `organic cotton` | | **Attribute values** | Matches any product attribute value | `steel grey`, `china` | | **GTIN** | Exact match on 8, 12, 13, or 14-digit identifiers | `5060999100063` | Product search is designed for rich, semantic discovery, so 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 Type | What's Searched | | --------------------------------------- | -------------------------------- | | Plain text (e.g. `winter gloves`) | Products only | | A GTIN (e.g. `5060999100063`) | Products (exact GTIN match) | | A UUID | Products, batches, and exports | | Mixed text and numbers (e.g. `GL4-123`) | Products, tokens, and batches | | A GS1 Digital Link URL | Automatically parsed (see below) | You never need to tell the system what type of object you're searching for, as 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, then 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 Type | Opens | | ----------- | ------------------- | | Product | Product detail page | | Token | Token detail page | | Batch | Batch detail page | | Export | Exports view | Use **↑** and **↓** arrow keys to move through results without leaving the keyboard. --- ## Keyboard Shortcuts | Shortcut | Action | | ------------------- | --------------------- | | **⌘K** / **Ctrl+K** | Open Spotlight Search | | **↑ ↓** | Navigate results | | **Enter** | Open selected result | | **Esc** | Close 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 | Rule | Detail | | -------------------- | ------------------------------------------------------------ | | Minimum query length | 2 characters | | Token serial minimum | 4 characters | | Scope | Workspace-scoped, only your workspace's objects are returned | | Pagination | Cursor-based for consistent performance at scale | ## Related Docs * [Products](/product-module/products) * [Minting Overview](/minting/overview) * [Resolver & GS1 Digital Link](/product-module/resolver-gs-1-digital-link) * [Product Identifiers](/product-module/identifiers)