Shopify Algolia global events

Autocomplete, InstantSearch, and Recommend in the Algolia app blocks now support version 5 of the Algolia API client. Most stores only need to switch the search client version setting to Version 5. If you use custom storefront JavaScript, follow the version 5 upgrade guide. Support for version 4 ends on August 14, 2026.

The events algolia.instantsearch.hitClickAction and algolia.autocomplete.hitClickAction are deprecated since March 31, 2025. Use beforeInstantSearchProductTemplate and beforeAutocompleteProductTemplate events instead.

The InstantSearch and Autocomplete libraries emit global events. You can’t pass data to the global events but you can listen to them.

algolia.autocomplete.beforeInit. Emitted before the Autocomplete library is initialized.
algolia.autocomplete.afterInit. Emitted after the Autocomplete library is initialized
algolia.autocomplete.hitClickAction (deprecated). Deprecated. Use beforeAutocompleteProductTemplatefor adding click events. Emitted when a user clicks on an Autocomplete result
algolia.instantsearch.beforeInit. Emitted before the InstantSearch library is initialized.
algolia.instantSearch.afterInit. Emitted after the InstantSearch library is initialized.
algolia.instantsearch.hitClickAction (deprecated). Deprecated. Use beforeInstantSearchProductTemplate for adding click events Emitted when a user clicks on an InstantSearch result
algolia.instantSearch.onError. Emitted when the InstantSearch library reports an error.
algolia.instantSearch.onRender. Emitted when all InstantSearch widgets have been rendered.
algolia.instantsearch.beforeInitSortOrders. Emitted before InstantSearch sorting is initialized.
algolia.instantsearch.beforeInitFacets. Emitted before InstantSearch facets are initialized.
algolia.hooks.initialize. Emitted before Algolia hooks have been initialized.
algolia.analytics.beforeInit. Emitted before the Algolia Insights API has been initialized.

Example

JavaScript

document.addEventListener("algolia.autocomplete.afterInit", function () {
  console.log("Autocomplete.js has been initialized");
});

​Example

Example