Quickstart

The Algolia Search and Discovery app replaces Shopify’s built-in search with Algolia’s fast and configurable search. Algolia connects to your Shopify store and indexes your products and collections. Your users can immediately find results thanks to Algolia’s autocomplete menu on every page. For more filtering options, you can add full search results pages.

Algolia Search and Discovery is a Shopify Plus certified app. You can use it with your Shopify Plus or Shopify stores.

Install Algolia Search and Discovery in your store

Go to https://shopify.algolia.com/install, enter your Shopify domain, and click Install app.

For more information, see Installing apps.

Optional: in the sidebar of your Shopify admin, click Pin to your navigation for the Algolia Search and Discovery app to always have quick access to your search settings.

Link your Algolia account

Click Get Started to continue with the automatic setup. If the automatic setup fails, click Use manual setup instead to continue with the manual setup.

Automatic setup

1. Sign in to your Algolia account or create a new one.

   After signing in, the Credentials page of the Algolia Search and Discovery app opens in your Shopify admin.

   

2. Select the Algolia application for your Shopify store. The Algolia Search and discovery app creates new API keys in your Algolia account and automatically adds them to this page.

3. Optional: change the prefix for your indices (default: shopify_). This is useful, if you want to connect multiple Shopify stores to the same Algolia application. This prefix is added to your index names, such as shopify_products.

4. Click Save.

Continue with the setup in the Configure a live store section.

Manual setup

1. Open the API Keys page in the Algolia dashboard.

2. Select the Algolia application, where you want to store the indices from your Shopify store.

   

3. From the API Keys page, copy the following credentials:

   • Application ID
   • Search-Only API Key
   • Admin API Key

   

4. On the Credentials page in the Algolia Search and Discovery app, paste the credentials you copied from the Algolia dashboard.

   

5. Optional: change the prefix for your indices (default: shopify_). This is useful, if you want to connect multiple Shopify stores to the same Algolia application. This prefix is added to your index names, such as shopify_products.

6. Click Save.

Continue in the Configure a live store section.

Configure a live store

If you want to add the Algolia Search and Discovery app to a live store, you should duplicate your theme, and add Algolia to the copy of the theme instead. This lets you preview changes, tweak your site’s CSS, and test that everything is working correctly.

Duplicate your theme

1. Duplicate your theme. The copy is added to your Theme library.

   

2. When the duplication is completed, go to the duplicate theme and click Customize.

   

Enable Algolia on your theme

1. In your Shopify admin, go to the Algolia Search and Discovery app.

2. On the Search Options tab, click Enable Algolia on a theme.

   

3. Select the copy of your theme and click Next.
4. If the theme has multiple layouts, select the layout where you want to add Algolia and click Finish installation.

To preview the theme with Algolia, click Preview. The default search box is now replaced with an Algolia autocomplete search box.

Configure the Algolia settings and test them with your preview theme.

Publish your theme

1. After testing your changes, go back to Online Stores > Themes in your Shopify admin.

2. Select the theme with Algolia and click Publish.

   

Your live store now uses a version of your theme with Algolia providing your search experience.