Gallery & Deep Links
Send customers directly to a filtered view of your catalog — a specific category, tag, or an individual design that opens automatically.
How Deep Links Work
Your StitchIQ catalog is served through Shopify's App Proxy at /apps/stitchiq on your store. By adding query parameters to this URL, you can send customers to a pre-filtered view with the correct category, tag, or design already active when the page loads.
Three types of deep links:
| Type | Parameter | Example |
|---|---|---|
| Category | ?category=Name | /apps/stitchiq?category=Logos |
| Tag | ?tag=name | /apps/stitchiq?tag=floral |
| Design | ?design=id | /apps/stitchiq?design=abc123 |
Your store's base URL
Replace your-store.myshopify.com with your actual Shopify store domain in all examples below.
Linking to a Category
Use ?category= to show only designs in a specific category. The name is case-sensitive and must match exactly as entered in the admin.
https://your-store.myshopify.com/apps/stitchiq?category=Logos
https://your-store.myshopify.com/apps/stitchiq?category=Sports
https://your-store.myshopify.com/apps/stitchiq?category=HolidayWhen a customer lands on a category link, only matching designs are shown and the category pill in the filter bar is highlighted automatically.
Getting the right name
Check the Category field on any of your designs in the StitchIQ admin — the URL value must match exactly, including capitalization.
Linking to a Tag
Use ?tag= to filter by a design tag. Tags are also case-sensitive.
https://your-store.myshopify.com/apps/stitchiq?tag=floral
https://your-store.myshopify.com/apps/stitchiq?tag=holiday
https://your-store.myshopify.com/apps/stitchiq?tag=sportsAdd category links to your store nav
Go to Online Store → Navigation in Shopify, click your menu, and add a menu item with the category URL. This is the fastest way to let customers browse your design catalog by type.
Linking to a Specific Design
Use ?design= with a design's ID to automatically open that design's detail modal when the catalog loads. The full catalog is visible behind the modal and customers can close it to browse more.
https://your-store.myshopify.com/apps/stitchiq?design=abc123You don't need to know the design ID manually — use the Copy link button inside the design modal instead (see below).
What the customer sees
- The catalog page loads with all designs visible in the background.
- The design modal opens automatically for the linked design.
- Thread colors, pricing, and the "Add to Cart" button are immediately available.
- Closing the modal returns them to the full catalog.
Using the Copy-Link Buttons
You don't need to construct URLs manually. StitchIQ provides copy buttons throughout the catalog:
Filter bar — category and tag links
Each category and tag pill in the filter bar has a small 🔗 icon next to it. Clicking it copies the shareable filtered URL to your clipboard and shows a confirmation message.
Individual design links
Open any design by clicking it — inside the modal, below the "Add to Cart" button, is a "🔗 Copy link to this design" button. Click it to copy the direct design URL.
The URL updates automatically
When a design is opened, the browser URL bar updates to include ?design=. Customers can copy that URL directly and share it — no button required.
Where to Use Your Links
| Use case | How |
|---|---|
| Store navigation | Add category links to your Shopify main menu |
| Email campaigns | Link to a seasonal tag collection or featured design |
| Social media | Share a specific popular design in your bio or posts |
| Product pages | Add a "Browse matching designs →" CTA button |
| Banners & popups | Promote a new collection with a filtered catalog link |
| Customer support | Paste a design link in a reply to show a specific design |
Adding Catalog Links to Shopify Navigation
- In your Shopify admin, go to Online Store → Navigation.
- Click the menu you want to edit (e.g. "Main menu").
- Click Add menu item.
- Set the Name (e.g. "Embroidery Catalog") and paste your URL into the Link field.
- Click Save and verify the link appears on your storefront.
Root-relative vs. full URLs
For the full unfiltered catalog, you can use the root-relative path /apps/stitchiq in Shopify navigation. For category/tag filtered links, use the full URL including your store domain.