Frequent issues

From December 31, 2023, Algolia’s Search and Discovery application can’t modify the coding of Shopify themes. For more information, refer to Shopify’s Asset API documentation. As an alternative, Algolia offers Shopify’s App Embed and App Blocks features for Autocomplete and InstantSearch interfaces. For more information, refer to the Quick start and Shopify Algolia configuration documentation.

The configuration file is out of date, or configuration changes aren’t applying

The root cause is the algolia_config.js file being out of date. This can happen if the theme isn’t configured within the Algolia app or if the configuration file is overwritten.

To confirm that the theme is configured within the app, check that it shows up in the list in the Search options tab.

If the theme doesn’t show up and if it already contains an algolia_config.js file, you can synchronize the themes by clicking on the Synchronize button:

If the theme shows up in the list and the configuration is still not updated, you can force the plugin to push the latest version of this file to the theme. Do this by updating any Algolia setting, then revert it. On any update, Algolia pushes the latest version of algolia_config.js file to your theme.

The configuration file gets overwritten when using Slate (or similar)

When using a versioned theme or a toolkit like Slate, the algolia_config.js file might get accidentally overwritten. To prevent this from happening, please ignore assets/algolia_config.js.liquid in your version control system. For example, when using Git, you can add it to your .gitignore file.

Products don’t get updated when marking them available/unavailable

When updating products from the Shopify’s Admin section using the batch Make available or Make unavailable action, Algolia doesn’t update. This is because Shopify does not send the proper webhook.

Update the availability of the products using the Availability field in the Bulk Editor:

• Select the desired products
• Click on Edit products
• If you don’t see the Availability field, add it using the Add fields button
• Mark the products as available/unavailable

This action triggers the correct webhook from Shopify, which will trigger an Algolia indexing.

This might be slower than using the batch action. Unfortunately, this is the only available workaround for now. Shopify have been informed about this issue.

Products getting duplicated across multiple shops

If you have multiple shops using the same Algolia application, and see overlapping or duplicate products across them, this might mean the shops are sharing the same index. Please ensure that different shops have different index prefixes. You can update prefixes by going to the Settings tab of the Algolia plugin.

Please note that updating the prefix will trigger a full reindex of your products, which may take some time.

The Algolia Autocomplete or InstantSearch isn’t visible

If you’ve installed the Algolia plugin for the first time, or moved to a new theme, and the Algolia autocomplete or InstantSearch isn’t visible, then:

1. Make sure the Autocomplete and InstantSearch options are selected.
   • The InstantSearch option is available on the Search Options tab in the Search Page category.
   • The Autocomplete option is available on the Display tab in the Autocomplete category.
2. Ensure that the CSS selector for both these options is targeting the correct element.
3. Go to the Active Installation section on the Display tab, and select the Install to a new theme option.

After this, the Algolia autocomplete or InstantSearch should work as expected.

Invalid Algolia credentials during installation

If you see the error message “There was an error with your Algolia credentials” when entering your credentials, then:

• Make sure you’ve entered the correct credentials.