# algolia/algoliasearch-magento-2

> Algolia Search & Discovery extension for Magento 2

`composer require algolia/algoliasearch-magento-2`

Canonical URL: https://packagento.com/algolia/algoliasearch-magento-2

## At a glance

- **Vendor**: algolia (https://packagento.com/algolia.md)
- **Latest version**: 3.19.0-beta.1 — released 2026-07-01
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/algolia/algoliasearch-magento-2 and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require algolia/algoliasearch-magento-2:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Algolia Search & Discovery extension for Magento 2

## README

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

![Latest version](https://img.shields.io/badge/latest-3.18.1-green)
![Magento 2](https://img.shields.io/badge/Magento-2.4.7+-orange)

![PHP](https://img.shields.io/badge/PHP-8.3%2C8.4%2C8.5-blue)

[![CircleCI](https://circleci.com/gh/algolia/algoliasearch-magento-2/tree/main.svg?style=svg)](https://circleci.com/gh/algolia/algoliasearch-magento-2/tree/main)

-------

### 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 & 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

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


### Magento 2.4 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

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

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

| Extension Version | End of Life | Magento                      | PHP                                    |
|-------------------|-------------|------------------------------|----------------------------------------|
| v3.7.x            | 10/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.x            | 3/8/2023    | `~2.4.5\|\|~2.4.6`           | `~7.4.0\|\|~8.1.0\|\|~8.2.0`           |
| v3.9.x            | 10/13/2023  | `~2.4.5\|\|~2.4.6`           | `~7.4.0\|\|~8.1.0\|\|~8.2.0`           |
| v3.10.x           | 12/12/2023  | `~2.4.6`                     | `~8.1.0\|\|~8.2.0`                     |
| v3.11.x           | 1/26/2024   | `~2.4.6`                     | `~8.1.0\|\|~8.2.0`                     |
| v3.12.x           | 8/2/2024    | `~2.4.6`                     | `~8.1.0\|\|~8.2.0`                     |
| v3.13.x           | 4/9/2025    | `~2.4.6`                     | `~8.1.0\|\|~8.2.0`                     |
| v3.14.x           | 9/1/2025    | `~2.4.6\|\|~2.4.7`           | `~8.1.0\|\|~8.2.0\|\|~8.3.0`           |
| v3.15.x           | 12/1/2025   | `~2.4.6\|\|~2.4.7`           | `~8.1.0\|\|~8.2.0\|\|~8.3.0`           |
| v3.16.x           | 5/15/2026   | `~2.4.7\|\|~2.4.8`           | `~8.2.0\|\|~8.3.0\|\|~8.4.0`           |
| v3.17.x           | N/A         | `~2.4.7\|\|~2.4.8`           | `~8.2.0\|\|~8.3.0\|\|~8.4.0`           |
| v3.18.0           | N/A         | `~2.4.7\|\|~2.4.8`           | `~8.2.0\|\|~8.3.0\|\|~8.4.0`           |
| >=v3.18.1         | N/A         | `~2.4.7\|\|~2.4.8\|\|~2.4.9` | `~8.2.0\|\|~8.3.0\|\|~8.4.0\|\|~8.5.0` |
| v3.19.x           | N/A         | `~2.4.7\|\|~2.4.8\|\|~2.4.9` | `~8.3.0\|\|~8.4.0\|\|~8.5.0`           |

### 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

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.18.0"`

#### 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.

_(README truncated for .md surface. Full README on https://packagento.com/algolia/algoliasearch-magento-2.)_

## Changelog

### 3.19.0-beta.1

#### Security
- Upgraded `guzzlehttp/guzzle` to `^7.12.1` to remediate two Dependabot CVEs (dot-only cookie domains matching all hosts, and silent HTTPS-proxy downgrade to cleartext); dropped the EOL `^6.3.3` branch ([#1964](https://github.com/algolia/algoliasearch-magento-2/pull/1964)).

#### Features
- Added support for the new Algolia Ingestion module (algolia/algoliasearch-ingestion-magento-2), which routes product indexing through the Algolia Ingestion API to unlock pre-indexing JavaScript transformations, low-latency Collections, and per-operation observability ([#1919](https://github.com/algolia/algoliasearch-magento-2/pull/1919)).
- Introduced a per-store `SendStrategy` resolver on `AlgoliaConnector`, enabling alternative indexing backends to be selected at the store scope while direct indexing remains the default ([#1924](https://github.com/algolia/algoliasearch-magento-2/pull/1924), [#1923](https://github.com/algolia/algoliasearch-magento-2/pull/1923)).
- Added `SearchClientProvider` and `AbstractClientProvider`, extracting Algolia client construction behind `ClientProviderInterface` / `SearchClientProviderInterface` so satellite modules can supply their own clients ([#1926](https://github.com/algolia/algoliasearch-magento-2/pull/1926), [#1928](https://github.com/algolia/algoliasearch-magento-2/pull/1928)).

#### Updates
- Unified temporary index management across entities so the move-to-production step is consistent for products, categories, pages, suggestions, and additional sections; page indexing now supports delta updates ([#1960](https://github.com/algolia/algoliasearch-magento-2/pull/1960)).
- Added `IndexSettingsPreserver` to retain ingestion-owned index settings across a full reindex, and reorganized the `Service/Index*` class family into `Service/Index/` and `Service/Index/Settings/` (no behavior change) ([#1961](https://github.com/algolia/algoliasearch-magento-2/pull/1961), [#1956](https://github.com/algolia/algoliasearch-magento-2/pull/1956)).
- Updated the Algolia PHP API Client to version 4.40.0 ([#1922](https://github.com/algolia/algoliasearch-magento-2/pull/1922)).
- Centralized the default store scope constant and added a reflection utility in preparation for the Ingestion task service ([#1927](https://github.com/algolia/algoliasearch-magento-2/pull/1927)).
- Added an `AlgoliaLogger` virtual type for PSR-3 substitution and a helper for resolving the original (production) name of a temporary index.
- Retired the `*Testable` subclass test pattern in favor of direct unit testing, and introduced reusable Claude testing guides alongside a regenerated `AlgoliaConnector` unit suite ([#1929](https://github.com/algolia/algoliasearch-magento-2/pull/1929)).
- Applied the updated `magento2-tools` PHPCS-Fixer linting baseline across the module for a consistent contribution standard, retaining PHP 8.2 backward compatibility ([#1923](https://github.com/algolia/algoliasearch-magento-2/pull/1923)).
- Refactored `ConfigHelper` and many block, controller, observer, and service classes to align with the new linting baseline and tighten type declarations.
- Hoisted CLI command unit tests to the `AbstractStoreCommand` scope ([#1942](https://github.com/algolia/algoliasearch-magento-2/pull/1942)).
- Added an architecture context document and adopted the open `AGENTS.md` standard for contributor and agent guidance ([#1921](https://github.com/algolia/algoliasearch-magento-2/pull/1921)).
- Updated unit and integration tests.

#### Bug fixes
- Added a missing CDATA tag in `system.xml`.

### 3.18.1

_(Changelog truncated for .md surface. Full history on https://packagento.com/algolia/algoliasearch-magento-2.)_

## Recent Versions

| Version | Released |
|---|---|
| 3.19.0-beta.1 | 2026-07-01 |
| 3.18.1 | 2026-06-15 |
| 3.17.4 | 2026-06-09 |
| 3.18.0 | 2026-05-20 |
| 3.18.0-rc1 | 2026-04-29 |
| 3.17.3 | 2026-03-06 |
| 3.17.3-rc1 | 2026-03-02 |
| 3.16.3 | 2026-03-02 |
| 3.18.0-beta.1 | 2026-02-23 |
| 3.17.2 | 2026-01-14 |

Showing 10 of 145 versions. Full release history on https://packagento.com/algolia/algoliasearch-magento-2.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| algolia/algoliasearch-client-php | ^4.40.0 |
| ext-dom | * |
| ext-json | * |
| ext-mbstring | * |
| ext-pdo | * |
| guzzlehttp/guzzle | ^7.12.1 |
| magento/framework | ~103.0 |
| php | ~8.3\|~8.4\|~8.5 |

### Require (dev)

| Package | Constraint |
|---|---|
| phpcompatibility/php-compatibility | ^9.2 |
| phpunit/phpunit | ^9.5\|^10.5\|^12.0 |

### Suggest

| Package | Constraint |
|---|---|
| algolia/algoliasearch-inventory-magento-2 | Algolia Search Inventory module for Magento 2.3.x,2.4.x and Algolia Search 1.12+ extension |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["algolia/algoliasearch-magento-2"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

algolia is a Magento 2 vendor on Packagento. See https://packagento.com/algolia.md for their full catalogue.