PHPackages                             algolia/algoliasearch-magento-2 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search &amp; Filtering](/categories/search)
4. /
5. algolia/algoliasearch-magento-2

ActiveMagento2-module[Search &amp; Filtering](/categories/search)

algolia/algoliasearch-magento-2
===============================

Algolia Search &amp; Discovery extension for Magento 2

3.17.3(2mo ago)1881.8M—2.4%170[4 PRs](https://github.com/algolia/algoliasearch-magento-2/pulls)14MITPHPPHP ~8.2|~8.3|~8.4

Since Aug 11Pushed 1mo ago73 watchersCompare

[ Source](https://github.com/algolia/algoliasearch-magento-2)[ Packagist](https://packagist.org/packages/algolia/algoliasearch-magento-2)[ RSS](/packages/algolia-algoliasearch-magento-2/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (486)Used By (14)Security (1)

Algolia Search &amp; Discovery extension for Magento 2
======================================================

[](#algolia-search--discovery-extension-for-magento-2)

[![Latest version](https://camo.githubusercontent.com/0b5905cac28445d7f5193428795ba96fdae2ddcd7cf2c22b43c76c3bda5312b3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61746573742d332e31372e332d677265656e)](https://camo.githubusercontent.com/0b5905cac28445d7f5193428795ba96fdae2ddcd7cf2c22b43c76c3bda5312b3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61746573742d332e31372e332d677265656e)[![Magento 2](https://camo.githubusercontent.com/ee41c413fcd202bfd715ad7059451ea5540c1da1d29f0a7e56e856b7a1a2fc5d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342e372b2d6f72616e6765)](https://camo.githubusercontent.com/ee41c413fcd202bfd715ad7059451ea5540c1da1d29f0a7e56e856b7a1a2fc5d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342e372b2d6f72616e6765)

[![PHP](https://camo.githubusercontent.com/95f7bf356f8da32c1f573069a13155adecea360519b1d216dfabfc1ce4148263/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e32253243382e33253243382e342d626c7565)](https://camo.githubusercontent.com/95f7bf356f8da32c1f573069a13155adecea360519b1d216dfabfc1ce4148263/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e32253243382e33253243382e342d626c7565)

[![CircleCI](https://camo.githubusercontent.com/b76eca77330e65ed739de6ad1f49901d4563dd78db887566f2a6c0708a90c35e/68747470733a2f2f636972636c6563692e636f6d2f67682f616c676f6c69612f616c676f6c69617365617263682d6d6167656e746f2d322f747265652f6d61696e2e7376673f7374796c653d737667)](https://circleci.com/gh/algolia/algoliasearch-magento-2/tree/main)

---

Features
--------

[](#features)

The Algolia extension replaces the default search in Magento Open Source and Adobe Commerce with a robust autocomplete search menu and Instantsearch results page.

This extension replaces the default search of Magento with a typo-tolerant, fast &amp; relevant search experience backed by Algolia. It's based on [algoliasearch-client-php](https://github.com/algolia/algoliasearch-client-php), [autocomplete.js](https://github.com/algolia/autocomplete.js) and [instantsearch.js](https://github.com/algolia/instantsearch.js).

- **Autocompletion menu:** Provide your entire catalog to End-Users instantly via the dropdown menu, regardless of the number of categories or attributes it contains.
- **Instantsearch results page:** Have your search results page, navigation and pagination updated in realtime, after each keystroke.
- **Recommend:** Algolia Recommend lets you display recommendations such as "Frequently Bought Together" and "Related Products" features on the product detail page.

Learn more at our [official website Adobe Commerce / Magento](https://www.algolia.com/search-solutions/adobe-commerce-magento/)

### Demo

[](#demo)

Try the Autocomplete and the InstantSearch results page on our [live demo](https://flagship-magento.algolia.com).

Magento 2.4 compatibility &amp; extension versions End of Life
--------------------------------------------------------------

[](#magento-24-compatibility--extension-versions-end-of-life)

Magento 2.3 and earlier versions are no longer supported by the Algolia extension.

Version 3.x of our extension is compatible with Magento 2.4. Review the [Customisation](https://github.com/algolia/algoliasearch-magento-2#customisation) section to learn more about the differences between our extension versions.

### Extension versions support

[](#extension-versions-support)

We support the two latest minor versions of our extension (see "Extension Version" column in the compatibility matrix below) :

- The 2 latest minor versions are maintained with security and critical bug fixes.
- The latest minor version is maintained with "general" bug fixes as well.

### Magento versions support

[](#magento-versions-support)

We support the 2 or 3 latest patch versions of Magento depending on releases overlap (see matrix below):

Extension VersionEnd of LifeMagentoPHPv3.7.x10/10/2023`~2.3.7||~2.4.5||~2.4.6``~7.3.0||~7.4.0||~8.1.0||~8.2.0`v3.8.x3/8/2023`~2.4.5||~2.4.6``~7.4.0||~8.1.0||~8.2.0`v3.9.x10/13/2023`~2.4.5||~2.4.6``~7.4.0||~8.1.0||~8.2.0`v3.10.x12/12/2023`~2.4.6``~8.1.0||~8.2.0`v3.11.x1/26/2024`~2.4.6``~8.1.0||~8.2.0`v3.12.x8/2/2024`~2.4.6``~8.1.0||~8.2.0`v3.13.x4/9/2025`~2.4.6``~8.1.0||~8.2.0`v3.14.x9/1/2025`~2.4.6||~2.4.7``~8.1.0||~8.2.0||~8.3.0`v3.15.x12/1/2025`~2.4.6||~2.4.7``~8.1.0||~8.2.0||~8.3.0`v3.16.xN/A`~2.4.7||~2.4.8``~8.2.0||~8.3.0||~8.4.0`v3.17.xN/A`~2.4.7||~2.4.8``~8.2.0||~8.3.0||~8.4.0`Documentation
-------------

[](#documentation)

- [Quick-Start and Installation](https://www.algolia.com/doc/integration/magento-2/getting-started/quick-start/)
- [General FAQs](https://www.algolia.com/doc/integration/magento-2/troubleshooting/general-faq/)
- [Technical Troubleshooting Guide](https://www.algolia.com/doc/integration/magento-2/troubleshooting/technical-troubleshooting/)
- [Indexing Queue](https://www.algolia.com/doc/integration/magento-2/how-it-works/indexing-queue/)
- [Frontend Custom Events](https://www.algolia.com/doc/integration/magento-2/customize/custom-front-end-events/)
- [Dispatched Backend Events](https://www.algolia.com/doc/integration/magento-2/customize/custom-back-end-events/)

### Installation

[](#installation)

The easiest way to install the extension is to use [Composer](https://getcomposer.org/) and follow our [getting started guide](https://www.algolia.com/doc/integration/magento-2/getting-started/quick-start/).

If you would like to stay on a minor version, please upgrade your composer to only accept minor versions. The following example will keep you on the minor version and will update patches automatically.

`"algolia/algoliasearch-magento-2": "~3.15.0"`

### Customisation

[](#customisation)

The extension uses libraries to help assist with the frontend implementation for autocomplete, instantsearch, and insight features. It also uses the Algolia PHP client to leverage indexing and search methods from the backend. When you approach customisations for either, you have to understand that you are customising the implementation itself and not the components it is based on.

These libraries are here to help add to your customisation but because the extension has already initialised these components, you should use hooks into the area between the extension and the libraries. Please check our [Custom Extension](https://github.com/algolia/algoliasearch-custom-algolia-magento-2) for refrence

### Frontend JavaScript libraries

[](#frontend-javascript-libraries)

> As of v3.15.x the JavaScript bundle `algoliaBundle` has been removed as a hard dependency for the Magento extension and will be removed entirely in the next minor release. Libraries can now be swapped independently and loaded via RequireJS.

Knowing the version of each Algolia JavaScript library will help you understand what is available for you to leverage in terms of customisation. This table will help you determine which documentation to reference when you start working on your customisation.

Extension Versionautocomplete.jsinstantsearch.jssearch-insights.jsrecommend-js.jsv3.x[0.38.0](https://github.com/algolia/autocomplete.js/tree/v0.38.0)\*[4.15.0](https://github.com/algolia/instantsearch.js/tree/v4.15.0)\*[1.7.1](https://github.com/algolia/search-insights.js/tree/v1.7.1)NAv3.9.1[1.6.3](https://github.com/algolia/autocomplete.js/tree/v1.6.3)\*[4.41.0](https://github.com/algolia/instantsearch.js/tree/v4.41.0)\*[1.7.1](https://github.com/algolia/search-insights.js/tree/v1.7.1)[1.5.0](https://github.com/algolia/recommend/tree/v1.5.0)v3.10.x[1.6.3](https://github.com/algolia/autocomplete.js/tree/v1.6.3)\*[4.41.0](https://github.com/algolia/instantsearch.js/tree/v4.41.0)\*[1.7.1](https://github.com/algolia/search-insights.js/tree/v1.7.1)[1.8.0](https://github.com/algolia/recommend/tree/v1.8.0)v3.11.0[1.6.3](https://github.com/algolia/autocomplete.js/tree/v1.6.3)\*[4.41.0](https://github.com/algolia/instantsearch.js/tree/v4.41.0)\*[2.6.0](https://github.com/algolia/search-insights.js/tree/v2.6.0)[1.8.0](https://github.com/algolia/recommend/tree/v1.8.0)v3.13.0[1.6.3](https://github.com/algolia/autocomplete.js/tree/v1.6.3)\*[4.63.0](https://github.com/algolia/instantsearch/tree/instantsearch.js%404.63.0)\*[2.11.0](https://github.com/algolia/search-insights.js/tree/v2.11.0)[1.8.0](https://github.com/algolia/recommend/tree/v1.8.0)v3.14.x[1.6.3](https://github.com/algolia/autocomplete.js/tree/v1.6.3)\*[4.63.0](https://github.com/algolia/instantsearch/tree/instantsearch.js%404.63.0)\*[2.11.0](https://github.com/algolia/search-insights.js/tree/v2.11.0)[1.15.0](https://github.com/algolia/recommend/tree/v1.15.0)v3.15.x[1.17.9](https://github.com/algolia/autocomplete.js/tree/v1.17.9)[4.77.0](https://github.com/algolia/instantsearch/tree/instantsearch.js%404.77.0)[2.17.3](https://github.com/algolia/search-insights.js/tree/v2.17.3)[1.16.0](https://github.com/algolia/recommend/tree/v1.16.0)&gt;=v3.16.x[1.18.1](https://github.com/algolia/autocomplete.js/tree/v1.18.1)[4.78.0](https://github.com/algolia/instantsearch/tree/instantsearch.js%404.78.0)[2.17.3](https://github.com/algolia/search-insights.js/tree/v2.17.3)[1.16.0](https://github.com/algolia/recommend/tree/v1.16.0)\* In earlier versions of the extension, the Autocomplete and InstantSearch libraries were accessible via the `algoliaBundle` global. This bundle was a prepackaged JavaScript file that contained dependencies for the frontend experience. What was included in this bundle can be seen here:

Refer to these docs when customising your Algolia Magento extension frontend features:

- [Autocomplete](https://www.algolia.com/doc/integration/magento-2/customize/autocomplete-menu/)
- [Instantsearch](https://www.algolia.com/doc/integration/magento-2/customize/instant-search-page/)
- [Frontend Custom Events](https://www.algolia.com/doc/integration/magento-2/customize/custom-front-end-events/)

### JavaScript bundling

[](#javascript-bundling)

Libraries should be fully compatible with [standard JavaScript bundling](https://developer.adobe.com/commerce/frontend-core/guide/themes/js-bundling/). If using ["advanced bundling"](https://experienceleague.adobe.com/en/docs/commerce-operations/performance-best-practices/performance-best-practices/advanced-js-bundling) via the [RequireJS optimizer](https://requirejs.org/docs/optimization.html) it will be necessary to first apply the Babel transpiler to the underlying source code.

A sample transpiler configuration (`.babelrc`) might look as follows:

```
{
    "presets": [
        [
            "@babel/preset-env",
            {
                "exclude": ["@babel/plugin-transform-template-literals"]
            }
        ],
        ["minify", { "builtIns": false, "mangle": false }]
    ],
    "comments": false
}
```

### The Algolia PHP API Client

[](#the-algolia-php-api-client)

The extension does most of the heavy lifting when it comes to gathering and preparing the data needed for indexing to Algolia. In terms of interacting with the Algolia Search API, the extension leverages the PHP API Client for backend methods including indexing, configuration, and search queries.

Depending on the extension version you are using, you could have a different PHP API client version powering the extension's backend functionality.

Extension VersionAPI Client Versionv3.x[2.5.1](https://github.com/algolia/algoliasearch-client-php/tree/2.5.1)v3.6.x[3.2.0](https://github.com/algolia/algoliasearch-client-php/tree/3.2.0)v3.11.0[3.3.2](https://github.com/algolia/algoliasearch-client-php/tree/3.3.2)&gt;=v3.14.x[4.0.x](https://github.com/algolia/algoliasearch-client-php/tree/4.0.0-beta.12)Refer to these docs when customising your Algolia Magento extension backend:

- [Indexing](https://www.algolia.com/doc/integration/magento-2/how-it-works/indexing/)
- [Dispatched Backend Events](https://www.algolia.com/doc/integration/magento-2/customize/custom-back-end-events/)

Support
-------

[](#support)

For feedback, bug reporting, or unresolved issues with the extension, please visit our [Support Center](https://support.algolia.com/hc/en-us/) where you can search the knowldge base and contact the Support team. Please include your Magento version, extension version, application ID, and steps to reproducing your issue. Add additional information like screenshots, screencasts, and error messages to help our team better troubleshoot your issues.

Contributing
------------

[](#contributing)

To start contributing to the extension follow the [contributing guildelines](.github/CONTRIBUTING.md).

###  Health Score

77

—

ExcellentBetter than 100% of packages

Maintenance88

Actively maintained with recent releases

Popularity60

Solid adoption and visibility

Community48

Growing community involvement

Maturity100

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~30 days

Recently: every ~13 days

Total

114

Last Release

73d ago

Major Versions

1.13.1 → 2.0.02020-04-16

1.13.2 → 2.0.12020-06-25

1.13.3 → 2.0.32020-09-29

2.0.3 → 3.0.02020-10-01

2.0.4 → 3.1.02021-02-24

PHP version history (9 changes)0.8.2PHP ~5.5.0|~5.6.0|~7.0.0

1.2.1PHP ~5.5.0|~5.6.0|~7.0

1.8.4PHP ~5.5.0|~5.6.0|~7.0|~7.1|~7.2

1.9.0PHP ~5.6.5|~7.0|~7.1|~7.2

1.10.0PHP ~5.6.5|~7.0|~7.1|~7.2|~7.3

1.12.1PHP ~7.0|~7.1|~7.2|~7.3

3.14.0-beta.1PHP ~8.1|~8.2

3.14.0-beta.2PHP ~8.1|~8.2|~8.3

3.16.0-beta.2PHP ~8.2|~8.3|~8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/b6d048f4c846e591bf24f521537e3ba9ba6ee1e0d7e466714c346c1a4cf7b576?d=identicon)[maxiloc](/maintainers/maxiloc)

![](https://www.gravatar.com/avatar/592b0cfa4c0bae27a4d0cae9befe00c8eab8156c9f35fcb705dc6471b2581477?d=identicon)[0livier](/maintainers/0livier)

![](https://www.gravatar.com/avatar/5397bc3560b352fd4f77e2b15e0e3fc59e1a189e4316b41e5c6b1cac177264cd?d=identicon)[damcou](/maintainers/damcou)

![](https://www.gravatar.com/avatar/7d4f40d5a164a4d213e6855abeb9f93faf46be1e5f6e47abd4a092f21fb31242?d=identicon)[bsuravech](/maintainers/bsuravech)

---

Top Contributors

[![cammonro](https://avatars.githubusercontent.com/u/986313?v=4)](https://github.com/cammonro "cammonro (910 commits)")[![mohitalgolia](https://avatars.githubusercontent.com/u/101385480?v=4)](https://github.com/mohitalgolia "mohitalgolia (668 commits)")[![damcou](https://avatars.githubusercontent.com/u/1649459?v=4)](https://github.com/damcou "damcou (585 commits)")[![JanPetr](https://avatars.githubusercontent.com/u/1058144?v=4)](https://github.com/JanPetr "JanPetr (281 commits)")[![ratikant-singh](https://avatars.githubusercontent.com/u/101382014?v=4)](https://github.com/ratikant-singh "ratikant-singh (124 commits)")[![bsuravech](https://avatars.githubusercontent.com/u/7048136?v=4)](https://github.com/bsuravech "bsuravech (109 commits)")[![omar-rahman-dev](https://avatars.githubusercontent.com/u/111445873?v=4)](https://github.com/omar-rahman-dev "omar-rahman-dev (83 commits)")[![mrahman3177](https://avatars.githubusercontent.com/u/167926401?v=4)](https://github.com/mrahman3177 "mrahman3177 (82 commits)")[![rachel-trott](https://avatars.githubusercontent.com/u/105296912?v=4)](https://github.com/rachel-trott "rachel-trott (55 commits)")[![rakesh-algolia](https://avatars.githubusercontent.com/u/101420377?v=4)](https://github.com/rakesh-algolia "rakesh-algolia (28 commits)")[![phirunson](https://avatars.githubusercontent.com/u/9425457?v=4)](https://github.com/phirunson "phirunson (14 commits)")[![nunomaduro](https://avatars.githubusercontent.com/u/5457236?v=4)](https://github.com/nunomaduro "nunomaduro (12 commits)")[![unicoder88](https://avatars.githubusercontent.com/u/4685931?v=4)](https://github.com/unicoder88 "unicoder88 (10 commits)")[![vmalyk](https://avatars.githubusercontent.com/u/5318027?v=4)](https://github.com/vmalyk "vmalyk (10 commits)")[![peterjaap](https://avatars.githubusercontent.com/u/431360?v=4)](https://github.com/peterjaap "peterjaap (8 commits)")[![maxiloc](https://avatars.githubusercontent.com/u/1689007?v=4)](https://github.com/maxiloc "maxiloc (8 commits)")[![palviggi-flagbit](https://avatars.githubusercontent.com/u/54845597?v=4)](https://github.com/palviggi-flagbit "palviggi-flagbit (6 commits)")[![julienbourdeau](https://avatars.githubusercontent.com/u/1525636?v=4)](https://github.com/julienbourdeau "julienbourdeau (5 commits)")[![jajajaime](https://avatars.githubusercontent.com/u/13631233?v=4)](https://github.com/jajajaime "jajajaime (5 commits)")[![0livier](https://avatars.githubusercontent.com/u/10607?v=4)](https://github.com/0livier "0livier (5 commits)")

---

Tags

algoliaalgolia-searchmagento-algoliasearchmagento2magento2-extensionphpsearch

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/algolia-algoliasearch-magento-2/health.svg)

```
[![Health](https://phpackages.com/badges/algolia-algoliasearch-magento-2/health.svg)](https://phpackages.com/packages/algolia-algoliasearch-magento-2)
```

###  Alternatives

[algolia/search-bundle

Algolia Search integration for Symfony

1931.5M2](/packages/algolia-search-bundle)[mageworx/module-searchsuiteautocomplete

Search Suite Autocomplete extension by MageWorx for Magento 2

34293.0k1](/packages/mageworx-module-searchsuiteautocomplete)[statamic-rad-pack/meilisearch

meilisearch search driver for Statamic

1661.7k](/packages/statamic-rad-pack-meilisearch)[mage-os/module-automatic-translation

Automatic AI content translation for Mage-OS.

277.1k](/packages/mage-os-module-automatic-translation)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
