Frequent Issues
The config file is out of date, or config changes aren’t applying
If you’re not using a versioned theme or a toolkit (such as Slate) and the config remains unapplied, then the algolia_config.js file might be out of date.
To force the plugin to push the latest version of this file to the theme, you can update any Algolia setting, then revert it.
On any update, we push the latest version of algolia_config.js file to your theme.
The config 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. We have let Shopify know about this issue, and hopefully it will get fixed soon.
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:
- 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.
- Ensure that the CSS selector for both these options is targeting the correct element.
- 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’re not using an Algolia Places application: Algolia Places is not compatible with our Shopify plugin.
- Make sure you’ve entered the correct credentials.
