What is Tagalys?

Tagalys is an e-commerce search and merchandising platform for Shopify merchants. It powers keyword search, facets, sort, autocomplete, popular searches, and Smart Widget recommendations, with region-specific Storefront API hosts.

Why Tagalys + Tapcart?

The Tagalys integration creates a fast, relevant search experience in your Tapcart app. Shoppers get query-driven product results, filters, sort, trending search terms, and optional recommendation widgets — while Shopify remains the source of truth for product pricing, variants, media, and availability (Tapcart hydrates Tagalys hits through Shopify).

What functionality can the Tagalys integration unlock? See the following:

Search

Keyword search results
Filtering (checkbox and range / price slider)
Sorting
Search suggestions / autocomplete
Popular / trending search terms (empty query)

Discovery

Collection PLPs without a search query use Shopify Search & Discovery (or your configured merch provider)
Keyword search, suggestions, popular searches, and filters via Tagalys

Recommendations / launcher

Smart Widget product carousels (Provider widget ID on Recommendations Carousel / search-results surfaces)
Pinned collections on the Trending Collections block (order controlled in Tapcart App Studio)

How to Connect Tagalys + Tapcart

Here’s how to set up this integration:

The integration is available to Tapcart customers with an active Tagalys Storefront API account. Setup is Solutions-assisted today — your Tapcart Solutions contact enables Tagalys on your app with you. A Dashboard integration for Tagalys is coming soon; until then, use the steps below with your Tapcart contact.

Before you start (merchant prerequisites in Tagalys)

Confirm you have a Tagalys Storefront account for each Shopify store / region you will power in Tapcart.
Obtain your Shop ID (usually the Shopify domain, e.g. your-store.myshopify.com).
Confirm the region base URL with Tagalys (for example https://api-r3.tagalys.com or https://api-r4.tagalys.com). Hosts differ by region.
For empty-state product carousels on search open: ask Tagalys to create a Smart Widget (best-sellers / trending) per store and share the widget ID.

Steps (connect in Tapcart)

Reach out to your Tapcart Solutions / Account contact (or LiveChat) to start a Tagalys enablement.
Gather Shop ID, region Base URL, and any optional facet / Smart Widget values (table below). Merchants do not need to provide a Storefront API key — Tapcart uses your shop ID for Storefront calls.
Your Tapcart contact enables tagalys-search on your app and applies the configuration with you.
Configure search layouts with native blocks (Sort and Filter Header, Product Grid, Search Input / Search Results, Trending Collections, Recommendations Carousel as needed).
Publish and QA with your Tapcart contact.

Coming soon: Merchants will be able to connect Tagalys from the Tapcart Dashboard Integrations gallery. Until that ships, setup remains Solutions-assisted.

Example integration payload

{   "name": "tagalys-search",   "enabled": true,   "baseUrl": "https://api-r3.tagalys.com",   "shopId": "your-store.myshopify.com",   "hiddenFilterFields": ["sale_price"],   "rangeFilterFields": ["sale_price"] }

Required merchant variables / credentials

Variable	Required?	Where to find it	Notes
Shop ID (`shopId`)	Yes	Tagalys / Shopify domain	e.g. `merchant.myshopify.com`
Base URL (`baseUrl`)	Strongly recommended	Tagalys (region host)	e.g. `https://api-r3.tagalys.com`, `https://api-r4.tagalys.com` — HTTPS only
Storefront API key (`apiKey`)	Not required from merchants	—	Tapcart uses the shop Storefront token path; you do not need to paste a Tagalys API key
Hidden filter fields	Optional	Tagalys facet ids	Facets to hide from the filter UI
Range filter fields	Optional	Tagalys range facet ids	e.g. `sale_price` so deep links encode min/max correctly
Smart Widget ID	Optional (for search-open carousel)	Tagalys Smart Widgets	Pasted on Recommendations Carousel / Provider widget ID in App Studio
Pinned collections	Optional	Your merchandising plan	Configured on Trending Collections in App Studio (not pulled from Tagalys pin order)

How to Configure Tagalys in Tapcart (App Studio)

Once the integration is enabled:

Search results

Use the standard Product Grid + Sort and Filter Header on search PLPs.
Keyword search requires a query — Tagalys is query-driven for /v2/search.

Popular / trending searches

Keep the Trending Search / search-suggestions blocks on the search launcher.
Popular terms come from Tagalys popular_searches when the query is empty. No extra credential beyond the integration.

Pinned collections (search launcher)

Open the Trending Collections block in App Studio.
In the right rail, set Pinned collections in the exact order you want shown before the shopper types.
Pin order is controlled in Tapcart, not by Tagalys dashboard pins (Tagalys does not pass pin order through the API Tapcart uses).
Once the shopper starts typing, collection suggestions switch to Tagalys query-scoped results.

Products on search open (before typing)

Ask Tagalys for a Smart Widget ID per store / region (best-sellers or trending).
On the Recommendations Carousel (or Search Results – Products surface that exposes Provider widget ID), paste the widget ID for that app / region.
The carousel can populate as soon as search opens; once the shopper types, live Tagalys search results take over for the search grid.

Collection pages (PLP without a query)

Collection PLPs without a search query use Shopify Search & Discovery (or your configured merch provider). Tagalys powers keyword search and related search surfaces; it is not used for default collection browse.

How to use Tagalys Search & Discover Integration?

Search functionality

General search — Required. Driven by shopper query via Tagalys /v2/search.
Suggestions — Autocomplete sections (searches, products, collections, pages) via /v2/search_suggestions.
Popular search — Empty-query trending terms via /v2/popular_searches.
Filtering — Checkbox facets (filter[field][]=value) and range / price slider (selected_min / selected_max).
Sorting — Tagalys sort options surfaced through the shared Sort and Filter Header.

Discovery functionality

Collection pages — Shopify Search & Discovery (or your configured merch provider) when there is no search query.
Widget recommendations — /v2/recommendations/{id} via Provider widget ID / recommendationId.
Product data — Always hydrated from Shopify after Tagalys returns ordered IDs/handles.

Verification / QA tips

Search for a known term; confirm products render with correct prices (Shopify hydration).
Apply a filter and Clear all; results should remain populated.
Open search with an empty query; confirm trending terms appear.
If using a widget ID, open search before typing and confirm the carousel fills.
Confirm pinned collections order matches App Studio, not A–Z Shopify fallback.
For multi-region brands, use the correct shopId + baseUrl per regional Shopify store.
Collection PLP without a query shows Shopify merchandising.

Considerations

Tagalys keyword search is query-required. Unlike some other providers, it does not return a default product set on an empty search unless you configure a Smart Widget / recommendations path.
Tagalys dashboard “pinned collections” are not automatically reflected in the app; use Tapcart Pinned collections.
Merchants do not need to paste a Tagalys Storefront API key; Tapcart uses the shop Storefront token path with your Shop ID.
Connection is Solutions-assisted today; Dashboard self-serve for Tagalys is coming soon.

Tagalys + Tapcart Integration