# instantsearch/instantsearchplus

> Search That Boosts Conversion: Fastest Semantic Search, Search Filters, and Search Autocomplete

`composer require instantsearch/instantsearchplus`

Canonical URL: https://packagento.com/instantsearch/instantsearchplus

## At a glance

- **Vendor**: instantsearch (https://packagento.com/instantsearch.md)
- **Latest version**: 4.91.51 — released 2026-05-28
- **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/instantsearch/instantsearchplus 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 instantsearch/instantsearchplus:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Search That Boosts Conversion: Fastest Semantic Search, Search Filters, and Search Autocomplete

## README

Magento AI‑Based Search & Merchandising To Maximize Conversion Rate.   
The best and fastest growing brands use [Fast Simon](https://www.fastsimon.com/) to improve and optimize their entire shopping experience.

[Fast Simon](https://www.fastsimon.com/) is helping merchants maximize the value of their online traffic to spark, sustain, and boost their growth. Current Fast Simon merchants report growth of up to 40% year-over-year after adopting the powerful search platform. 

Boost Conversion with Search, Merchandising  & Personalization

* Shoppers using search are on 4X more likely to buy
* Great Search can boost conversion by 30-150%
* Cross-sell & Upsell increase sales by up to 30%
* Personalization will boost conversion rates up to 50%
* Smart online merchandising that keeps you in control

Installation
------------
1.	Visit and purchase the free [Fast Simon](https://www.fastsimon.com/magento-commerce/) Extension at [Magento Marketplace](https://marketplace.magento.com/instantsearch-instantsearchplus.html)
2.  Connect to your server through SSH terminal (e.g. PUTTY.exe)
3.	Navigate to your Magento root (where app folder is)
4.	Make sure **php** is in your environment path (run ```php --help```  - see that you get list of possible commands) if  not - contact your server provider to find path to ftp executable.
5.	Enable maintenance mode ```php bin/magento maintenance:enable```
6.	Run following commands:  
	a.	```composer require instantsearch/instantsearchplus```  
	b.	Insert your public/private keys, as username/password from [Your Account](https://experienceleague.adobe.com/docs/commerce-operations/installation-guide/prerequisites/authentication-keys.html?lang=en)  
	c.	```php bin/magento module:enable Autocompleteplus_Autosuggest --clear-static-content```  
	d.	```php bin/magento setup:upgrade```  
	e.	```php bin/magento setup:di:compile```  
	e.	```php bin/magento cache:clean```  
	f.	```php bin/magento maintenance:disable```  
    

Upgrade
------------  
1. Run following commands  
	a.	```composer require instantsearch/instantsearchplus:REPLACE_ME_WITH_THE_LAST_VERSION_NUMBER```  
	b.	```php bin/magento setup:upgrade```  
	c.	```php bin/magento setup:di:compile```  
	d.	```php bin/magento cache:clean```

## Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).

### [4.91.51] - 2026-05-28 19:00:00
#### Added
- Add `images_width` parameter to control the resize width of Product images in the feed (`0` = original/source resolution)

### [4.91.50] - 2026-05-04 19:00:00
#### Changed
- Faster and more reliable catalog sync across category saves, product imports, mass attribute updates, and price reindexes

### [4.91.45] - 2026-04-14 19:00:00
#### Added
- Include `include_in_menu` flag in category feed payload

### [4.91.44] - 2025-10-14 19:00:00
#### Fixed
- Fix configurable product price calculation to exclude expired special prices

### [4.91.43] - 2025-08-03 19:00:00
#### Added
- Support swatch type attributes for products and variants
- Support multiple images per variant

### [4.91.42] - 2025-07-27 20:00:00
#### Fixed
- Adhere to PHP 8.4 standards by adding nullable type hints in AbstractCollection constructor

### [4.91.41] - 2025-07-27 19:00:00
#### Fixed
- Adhere to Magento 2 security standards by updating image ID generation fallback to use SHA-256 hash instead of md5.

### [4.91.40] - 2025-07-27 18:00:00
#### Added
- Enhance Product XML generation to include optional media gallery images

### [4.91.36] - 2025-07-09 18:00:00
#### Fixed
- Potential error in Webhook observer

### [4.91.35] - 2025-03-19 19:00:00
#### Added
- Add `strip_tags` parameter to sanitize XML output

### [4.91.34] - 2025-03-16 19:00:00
#### Fixed
- Handle double-encoded HTML entities in XML generation

### [4.91.33] - 2024-12-09 19:00:00
#### Changed
- Optimized landing pages script

### [4.91.32] - 2024-07-17 14:00:00
#### Changed
- Added error logging in shopping events observers
- Added support for HTTPS requests in Api helper function

### [4.91.31] - 2024-07-08 20:00:00
#### Changed
- Update labels naming from 'InstantSearch+' to 'Fast Simon'
- Update error handling and error messaging in various modules

### [4.91.30] - 2024-01-17 18:00:00
#### Changed
- Updated Fast Simon API URLs

### [4.91.25] - 2023-11-15 18:00:00
#### Fixed
- PHTML syntax error fixes
- More PHP 8.2 deprecated functionality fixes
- Updatesitemap endpoint fix

### [4.91.24] - 2023-11-14 20:00:00
#### Fixed
- PHP 8.2 deprecated functionality fix

### [4.91.23] - 2023-11-01 21:00:00
#### Fixed
- Magento coding standard security fixes

### [4.91.22] - 2023-06-29 17:00:00
#### Fixed
- Magento 2.4.6 tests fix

### [4.91.21] - 2023-06-27 14:00:00
#### Fixed
- PHP 8.2 fix

### [4.91.20] - 2023-06-26 16:00:00
#### Changed
- Migrated to the declarative schema format

### [4.91.10] - 2023-06-22 14:00:00
#### Changed
- Magento 2.4.6 compatibility updates

### [4.91.06] - 2023-04-24 16:00:00
#### Fixed
- php 8.1 deprecation warning

### [4.91.05] - 2023-04-05 16:00:00
#### Fixed
- php 8.1 deprecation warning

### [4.91.04] - 2023-03-13 19:41:00
#### Fixed
- php 8.1 "passing null to parameter of type string is deprecated" warning

### [4.9.42] - 2023-02-02 14:41:00
#### Changed
- better handling of product images
#### Added
- Getimage endpoint

### [4.9.41] - 2023-01-02 14:41:00
#### Changed
- better handling of commas in select attributes

### [4.9.4] - 2022-12-21 20:41:00
#### Added
- Setispgroup endpoint

### [4.9.393] - 2022-11-22 12:41:00
#### Fixed
- php 8 support

### [4.9.392] - 2022-11-13 12:41:00
#### Fixed
- php 8 support

### [4.9.391] - 2022-11-07 12:41:00
#### Fixed
- deprecated log prints

### [4.9.39] - 2022-10-13 12:41:00
#### Fixed
- v-next frontend features support

### [4.9.38] - 2022-06-29 16:41:00
#### Added
- price compare at price on variant level support

### [4.9.37] - 2022-06-08 20:41:00
#### Removed
- script preloader

### [4.9.36] - 2022-06-08 11:41:00
#### Added
- script preloader
#### Fixed
- no-code editor configuration

_(Changelog truncated for .md surface. Full history on https://packagento.com/instantsearch/instantsearchplus.)_

## Recent Versions

| Version | Released |
|---|---|
| 4.91.51 | 2026-05-28 |
| 4.91.50 | 2026-05-04 |
| 4.91.45 | 2026-04-14 |
| 4.91.44 | 2025-10-14 |
| 4.91.43 | 2025-08-03 |
| 4.91.42 | 2025-07-27 |
| 4.91.41 | 2025-07-27 |
| 4.91.40 | 2025-07-27 |
| 4.91.35 | 2025-03-19 |
| 4.91.34 | 2025-03-16 |

Showing 10 of 146 versions. Full release history on https://packagento.com/instantsearch/instantsearchplus.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| laminas/laminas-filter | >=2.12.0 |
| laminas/laminas-http | >=2.14.3 |
| php | >=7.1 |

### Require (dev)

| Package | Constraint |
|---|---|
| magento-ecg/coding-standard | ^2.0 |

## Quality

Latest release (4.91.51) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 707 | 707 warnings (ruleset: Magento2) — 335 auto-fixable with phpcbf |
| PHPMD | Warning | 103 | 103 rule violations (UnusedLocalVariable:20, UnusedFormalParameter:15, MissingImport:14, CyclomaticComplexity:14, NPathComplexity:10) |
| Cpd | Pass | 0 |  |
| Composer validate | Info | 3 | valid; 3 advisory notes (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 149 | 149 | – | – |
| 2.4.8 | – | 149 | 149 | – |
| 2.4.9 | – | – | 149 | 149 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## 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=["instantsearch/instantsearchplus"],
  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

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

