Skip to main content
As of December 31, 2023, Shopify no longer allows apps to modify theme code. To integrate Autocomplete and InstantSearch, use the Algolia AI Search & Discovery app’s App Embed and App Blocks. To get started, see Quickstart and Algolia configuration.
Algolia AI Search & Discovery includes a search results page powered by InstantSearch. It replaces your default Shopify search results page and comes with several InstantSearch widgets. InstantSearch results page with widgets for filtering by price range or vendor and products displayed as cards

​
Enable the InstantSearch results page

To enable the InstantSearch results page:
  1. Enable Algolia Search App Embed in your theme settings.
  2. Enable Algolia App Blocks.

​
Configuration

To configure the InstantSearch page, go to the Search options tab in your Shopify app. InstantSearch configuration screen in the Shopify admin For advanced customization, use custom hooks.

​
No results

To tailor the message displayed when a search yields no results, use the templates.empty option provided by the InstantSearch hits widget. This lets you define custom HTML or text to inform users appropriately. For more information, see Customize an InstantSearch widget.

​
Facet display

Algolia AI Search & Discovery supports facet display to manage facet ordering from the Algolia dashboard.

​
Enable the facet display beta feature

Facet display is available as a beta feature in the Algolia AI Search & Discovery app, as defined in the Algolia Terms of Service (“Beta Services”). If you need access, contact the Algolia support team.
To enable facet display, select the checkbox in your Shopify admin and click Save. Facet display checkbox in the Shopify admin This activates facet display and maps your collection facet rules to your Algolia indices.

​
Facet display rules

Enabling facet display creates two types of rules:
  • Search page rules
  • Collection page rules

​
Search page rules

Search page rules use the shopify_default_collection context and apply to collection pages that aren’t customized. Search page rule in the Algolia dashboard To change facet display for search pages, edit the feature in the Algolia dashboard. For example: Facet display setting in the Algolia dashboard

​
Collection page rules

Collection page rules are triggered by the collection’s handle and its ID. Collection page rule in the Algolia index To change these rules, edit them in the Algolia dashboard. Facet display rule in the Algolia dashboard If you deactivate the feature, Algolia removes the rules from your dashboard but retains them in your Shopify admin for future reactivation.
⌘I