InstantSearch results page

Display search results from Algolia in your Shopify app using InstantSearch.

Shopify apps can’t modify theme code directly. To integrate Autocomplete and InstantSearch, use the Algolia AI Search & Discovery app’s App Embed and App Blocks.

For more information, see:

• Manual theme configuration
• Shopify 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.

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.

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.

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.

To change facet display for search pages, edit the feature in the Algolia dashboard. For example:

Collection page rules

Collection page rules are triggered by the collection’s handle and its ID.

To change these rules, edit them 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.