PHPackages                             drinks-it/smile-elasticsuite - 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. [API Development](/categories/api)
4. /
5. drinks-it/smile-elasticsuite

ActiveMagento2-component[API Development](/categories/api)

drinks-it/smile-elasticsuite
============================

Magento 2 merchandising and search engine built on ElasticSearch

2.10.111(5y ago)00OSL-3.0PHP

Since Mar 29Pushed 5y agoCompare

[ Source](https://github.com/drinks-it/elasticsuite)[ Packagist](https://packagist.org/packages/drinks-it/smile-elasticsuite)[ Docs](https://github.com/Smile-SA/elasticsuite)[ RSS](/packages/drinks-it-smile-elasticsuite/feed)WikiDiscussions 2.10.x Synced 2d ago

READMEChangelog (2)Dependencies (12)Versions (100)Used By (0)

[![Build Status](https://camo.githubusercontent.com/1ef0aa4593187205d648eeee8013a368411a9f1a3c9044fc521c2820d8dee173/68747470733a2f2f7472617669732d63692e6f72672f536d696c652d53412f656c617374696373756974652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/Smile-SA/elasticsuite) [![Packagist](https://camo.githubusercontent.com/b6a89c86c37844ca4824e06a561dbbd22f14c6cb9916892620ed558f0ca23b27/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736d696c652f656c617374696373756974652e7376673f7374796c653d737175617265)](https://camo.githubusercontent.com/b6a89c86c37844ca4824e06a561dbbd22f14c6cb9916892620ed558f0ca23b27/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736d696c652f656c617374696373756974652e7376673f7374796c653d737175617265)[![star this repo](https://camo.githubusercontent.com/ef6dbca490ea41020346bbb530c189013ef31a4b343af0fbf2afd68392f8babe/687474703a2f2f6769746875626261646765732e636f6d2f737461722e7376673f757365723d736d696c652d7361267265706f3d656c61737469637375697465267374796c653d64656661756c74)](https://github.com/smile-sa/elasticsuite)[![fork this repo](https://camo.githubusercontent.com/3a88fd66d48ee4471d1b1b66f626598d7251202312572e5adc02e1e4c93c814a/687474703a2f2f6769746875626261646765732e636f6d2f666f726b2e7376673f757365723d736d696c652d7361267265706f3d656c61737469637375697465267374796c653d64656661756c74)](https://github.com/smile-sa/elasticsuite/fork) [![GitHub contributors](https://camo.githubusercontent.com/ef6d8d4f1b33a1acd79173d6b84823c0811541caaeca5b481e4199cc8eb505a0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f736d696c652d73612f656c617374696373756974652e7376673f7374796c653d737175617265)](https://camo.githubusercontent.com/ef6d8d4f1b33a1acd79173d6b84823c0811541caaeca5b481e4199cc8eb505a0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f736d696c652d73612f656c617374696373756974652e7376673f7374796c653d737175617265) [![PRs Welcome](https://camo.githubusercontent.com/6082fca5371bee754f4d88fe5e775bce689488c1666c226989194d21fe8c175b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d627269676874677265656e2e7376673f7374796c653d737175617265)](https://github.com/Smile-SA/elasticsuite/pulls) [![Open Source Love](https://camo.githubusercontent.com/c77b1fc61b3de1a0800e43900528bd944eaa4dc98ea39837cf58556f78c9af34/68747470733a2f2f6261646765732e66726170736f66742e636f6d2f6f732f76332f6f70656e2d736f757263652e706e673f763d313033)](https://camo.githubusercontent.com/c77b1fc61b3de1a0800e43900528bd944eaa4dc98ea39837cf58556f78c9af34/68747470733a2f2f6261646765732e66726170736f66742e636f6d2f6f732f76332f6f70656e2d736f757263652e706e673f763d313033)

 [![Smile](doc/static/elasticsuite-logo.jpg)](doc/static/elasticsuite-logo.jpg)

News
----

[](#news)

### ⚠️ Magento versions compatibility :

[](#️-magento-versions-compatibility-)

Due to several changed in Magento 2.4.0, we cannot ensure compatibility between ElasticSuite &lt;2.10 and Magento &gt;=2.4.0 versions.

If your project is based on **Magento &gt;= 2.4.0**, you can start working with ElasticSuite today using the latest **2.10.x release**.

**Which version should I use ?**

Magento VersionElasticSuite Latest VersionSupported Elasticsearch VersionActively maintainedMagento **2.0.x** Opensource (CE) / Commerce (EE)ElasticSuite **2.1.x** : `composer require smile/elasticsuite ~2.1.0`2.xNoMagento **2.1.x** Opensource (CE) / Commerce (EE)ElasticSuite **2.3.x** : `composer require smile/elasticsuite ~2.3.0`2.x &amp; 5.xNoMagento **2.2.x** Opensource (CE) / Commerce (EE)ElasticSuite **2.6.x** : `composer require smile/elasticsuite ~2.6.0`5.x &amp; 6.xNoMagento **&lt;2.3.5** Opensource (CE) / Commerce (EE)ElasticSuite **2.8.x** : `composer require smile/elasticsuite ~2.8.0`5.x &amp; 6.xNoMagento **&gt;=2.3.5** Opensource (CE) / Commerce (EE)ElasticSuite **2.9.x** : `composer require smile/elasticsuite ~2.9.0`6.x &amp; 7.x**Yes**Magento **&gt;=2.4.0** Opensource (CE) / Commerce (EE)ElasticSuite **2.10.x** : `composer require smile/elasticsuite ~2.10.0`6.x &amp; 7.x**Yes**### Magento2 B2B Compatibility

[](#magento2-b2b-compatibility)

If your are using Magento Commerce (formerly known as Enterprise Edition) B2B feature with Elasticsuite, you will need to install :

- **Elasticsuite Shared Catalog** module which is located [here](https://github.com/Smile-SA/magento2-module-elasticsuite-shared-catalog)
- **Elasticsuite Quick Order** module which is located [here](https://github.com/Smile-SA/magento2-module-elasticsuite-quick-order)

### Introducing Elasticsuite modules

[](#introducing-elasticsuite-modules)

We are glad to announce officially that we now have a complete list of **additional modules to Elasticsuite**, which are all available for free and are published Open Source on Github :

Module NameDescription[CMS Search](https://github.com/Smile-SA/module-elasticsuite-cms-search)Allow to search for CMS pages (in autocomplete and search results).[Ratings](https://github.com/Smile-SA/magento2-module-elasticsuite-rating)Allow to filter and/or sort on ratings (based on standard Magento rating module).[Elasticsuite for Retailers](https://github.com/Smile-SA/elasticsuite-for-retailer)A complete suite of retail oriented modules : Store Locator, Price segmentation per store, etc...[TargetRules with Elasticsearch](https://github.com/Smile-SA/magento2-module-elasticsuite-targetrule)This module allow to compute target rules via Elasticsearch instead of full MySQL (**require Magento Commerce (EE)**).### Community Add-ons

[](#community-add-ons)

We have now some of our fellow users that are distributing **add-ons for ElasticSuite**. We would like to thanks them for supporting and using ElasticSuite.

Here is a list of currently published add-ons :

Add-on NameDescription[ComWrap ElasticsuiteBlog](https://github.com/comwrap/Comwrap_ElasticsuiteBlog)A bridge to use ElasticSuite with [MageFan Blog](https://github.com/magefan/module-blog).
 It allows to index Blog posts into the search engine and display them into the autocomplete results, and also on the search result page.What is ElasticSuite for Magento 2 ?
------------------------------------

[](#what-is-elasticsuite-for-magento-2-)

ElasticSuite is a merchandising suite for Magento which aims to provide out the box a lot of features usually only available with proprietary merchandising tools.

The project was originally created by Smile and released to the Open Source community for Magento 1.x. You can still find the Magento 1.x module [here](https://github.com/Smile-SA/smile-magento-elasticsearch).

Who is developing ElasticSuite ?
--------------------------------

[](#who-is-developing-elasticsuite-)

 [![Smile](doc/static/smile.png)](http://www.smile-oss.com)

 [![Smile](doc/static/sponsoredby_smileinovation.jpg)](http://www.smile-oss.com)

ElasticSuite is built by the Innovation board of Smile.

Smile is the **European leader of Open Source** and also a four-times **Europe Partner of the the Year** (2010-2014), two-times **Spirit of Excellence** (2015-2016), **Global Elite Partner** (2017-now), and **Regional Commercial Partner** (2018) awarded by Magento.

Our multidisciplinary team brings together experts in technology, innovation, and new applications.

Together we explore, invent, and test technologies of the future, to better serve our clients.

Where can I see it in action ?
------------------------------

[](#where-can-i-see-it-in-action-)

A demonstration store including the latest version of ElasticSuite is available here : [ElasticSuite Demo](http://demo.magento-elastic-suite.io/)

How to contribute ?
-------------------

[](#how-to-contribute-)

Contributions can take the form of new components or features, changes to existing features, tests, documentation (such as developer guides, user guides, examples, or specifications), bug fixes, optimizations, or just good suggestions.

To learn about how to make a contribution, click [here](https://github.com/Smile-SA/elasticsuite/blob/master/.github/CONTRIBUTING.md).

To learn about issues, click here. To open an issue, click [here](https://github.com/Smile-SA/elasticsuite/issues/new/choose).

Main Features
-------------

[](#main-features)

### Current version

[](#current-version)

The current version **2.10.0** has been focused on the **Compatibility with Magento 2.4.0**.

Feel free to read the whole changelog of this version [here](https://github.com/Smile-SA/elasticsuite/releases/tag/2.10.0)

This version is designed to be used on both Magento Open Source and Commerce versions &gt;2.4.

Actually, there are the features actually included :

- **Virtual categories :**

    ElasticSuite allows you to **define categories based on rules** (in addition to the standard manual selection). The rule definition is based on the Magento rules components, so you will not be disoriented. You are able to define categories such as "All products for men that are currently discounted".

    The engine will automatically refresh products matching the selection in Front-Office and will prevent you from having to re-assign products manually.

    [![Virtual Categories](doc/static/virtual_category.png)](doc/static/virtual_category.png)

    A dynamic preview of the results in the Back-Office is also included for more convenience.

- **Search optimizations :**

    ElasticSuite also features several ways to **optimize the search engine relevance**. This part is again based on rules that can be defined in the Magento's back-office.

    This allows you to create rules like "Boost all products that are in stock", "Boost all new products", "Boost men products", etc ...

    [![Search Optimizers](doc/static/search_optimizers.png)](doc/static/search_optimizers.png)

    You are also able to **preview each fine-tuning before publishing it** :

    [![Search Optimizers Preview](doc/static/search_optimizers_preview.png)](doc/static/search_optimizers_preview.png)

- **Categories Merchandising :**

    A new **Merchandising** panel has been added into the category edition screen of Magento's Back-Office. It features a **direct preview** of the current product list according to category settings.

    Inside this panel, you are also able to use a **drag-and-drop interface** to apply custom sort order on some of the category products.

    This feature is compatible with "standard" categories but also with the Virtual Categories described before.

    [![Virtual Categories](doc/static/virtual_categories_dnd.gif)](doc/static/virtual_categories_dnd.gif)

- **Facet Management by category :**

    Inside the **Display Settings** panel of each category, you will be able to customize various layered navigation filters parameters :

    - Filter position (pinned/unpinned)
    - Display mode (always hidden, always displayed, automatic mode)
    - Facet Max Size
    - Facet coverage
    - Facet sort order

    This allow you to have a deeper level of configuration for your layered navigation for each category.

    [![Facet by category](doc/static/facet-by-category.png)](doc/static/facet-by-category.png)

- **Search Analytics :**

    ElasticSuite features a **Search Usage dashboard**.

    It gives to the merchants merchandising team a dashboard displaying the following panels :

    - Global metrics : **number of searches**, pages views, **sessions with/without search** and number of unique visitors.
    - **Popular search terms** : to see what is actually **trending**, and **how often a given search term is bringing conversion**.
    - **Spellchecked search terms** : to **identify common mistakes** and fix them with [Thesaurus](https://github.com/Smile-SA/elasticsuite/wiki/ThesaurusAdministration).
    - **0 results search terms** : to create a redirect for these search terms or to customize them.
    - Percentage of **sessions with search against sessions without search**.
    - Percentage of **spellchecked requests**.
    - **Conversion rate** for session with search against sessions without search.

    [![Search Analytics](doc/static/search-analytics.png)](doc/static/search-analytics.png)

- **Search Terms Merchandising :**

    A new **Merchandiser** link has been added into the search term screen of Magento's Back-Office. It features a **direct preview** of the current product list that will be returned by this search query in front office.

    Inside this panel, you are also able to use a **drag-and-drop interface** to apply custom sort order on some of the products (Eg : to ensure your bestseller always appear at first position).

    [![Term Merchandiser](doc/static/term-merchandiser.gif)](doc/static/term-merchandiser.gif)

- **Products, Categories &amp; Attributes autocomplete :**

    ElasticSuite features **enhanced content in the autocomplete box** : popular search terms, **products and categories**, and also **attributes**.

    The autocomplete is **fully extensible to add custom content**, such as shop pages (if your store uses a store locator), CMS pages, etc...

    You can see the [wiki page](https://github.com/Smile-SA/elasticsuite/wiki) about adding custom content into the autocomplete results.

    [![Products Autocomplete](doc/static/enhanced_autocomplete.gif)](doc/static/enhanced_autocomplete.gif)

- **Enhanced thesaurus management :**

    Thesaurus are now managed directly by the engine instead of the legacy Magento's behavior.

    Our module allows you to add complete thesauri in the Magento Back-Office. Actually, the module supports **two types of thesauri** :

    - Synonyms : standard synonym feature, let you contribute a list of terms which are synonyms of each others.

    [![Synonyms](doc/static/synonyms.png)](doc/static/synonyms.png)

    This means that adding a synonym between *"men"* and *"man"* will make it working in all queries containing *"men"* like *"men shirt"* or *"men pants"* instead of having to define a synonym for each query.

    - Expansions : this kind of thesaurus allows to expand all search for a given term to an other list of terms.

    [![Expansions](doc/static/expansions.png)](doc/static/expansions.png)

    This means that adding an expansion between *"sport"* and *"fitness, gym, running"* will make it expanding for all queries containing *"sport"* like *"sport shoes"* (which would be expanded to "fitness shoes", "gym shoes", and "running shoes").

- **Autocomplete in layered navigation filters :**

    The module allows the users to search into filters values **via an autocomplete box**.

    [![Facet Autocomplete](doc/static/facet-autocomplete.gif)](doc/static/facet-autocomplete.gif)

- **Enhanced price slider :**

    The module features an **out of the box price slider**.

    [![Price Slider](doc/static/price_slider.png)](doc/static/price_slider.png)

- **Multiple select in layered navigation :**

    The module allows customers to **apply multiple values of the same filter** criteria.

    [![Multi Select Facet](doc/static/multiselect_facet.png)](doc/static/multiselect_facet.png)

- **Multiple select for swatches :**

    Same as above, the module allow the users to **choose several swatches** for filtering.

    [![Multi Select Swatches](doc/static/multiselect_swatches.png)](doc/static/multiselect_swatches.png)

- **Redirect on one result :**

    The module allow to redirect to the product page when a full text search matches only one product.

    [![Redirect One Result](doc/static/redirect_one_result.png)](doc/static/redirect_one_result.png)

- **Approaching search and spellchecking :**

    The module **automatically detects typing mistakes** and handles correct results for them. Don't worry about "fat-finger syndrome" anymore !

    [![Approaching Search](doc/static/approaching_search.png)](doc/static/approaching_search.png)

- **Automatic stopwords detection :**

    The module is able to **automatically detect "stopwords"** based on their frequency into the search index. This means the engine is able to deal with queries containing stopwords, but also with **pure stopwords queries** such as "to be or not to be" or even "he and she"!

- **Fully Configurable relevance configuration :**

    You are able to customize - on your own, via a dedicated screen in Magento's back-office - each technical parameters that are used to communicate with ElasticSearch. Doig so, you can **fine-tune the engine's configuration** to fit your needs according to your store's data typology.

- **Customizable filters :**

    Each attribute can now be configured in Magento's back-office to **change its behavior when used for filtering**

    - Conditional display of the filter based on its coverage rate.
    - Maximum number of elements displayed by the filter.
    - Sort order of elements of the filter.

    [![Facet Configuration](doc/static/facet_configuration.png)](doc/static/facet_configuration.png)

### And more to come !

[](#and-more-to-come-)

The next versions that will be coming all among this year will include the following features :

- **Behavioral Search optimizations :**

    Second part of the relevance optimization features will be the behavioral optimizers. This will allow you to build **rules matching your customer's behavior**. Thanks to this feature, optimization rules like "Apply a boost for most viewed products" or "Boost the top sales products" are now possible to create.
- **Recommendations engine :**

    On top of the behavioral analysis part will come our recommendations engine. It will allow you to propose **custom recommendations to your customers, based on their previous visits on your websites**, and on other customer behaviors.

    Planned recommendations features are :

    - "Customers also bought"
    - Similar products
    - Cross Selling
    - Per-user recommendations, based on current customer profile and its previous visits and orders.
    - Per-search recommendations, to push products that were bought by previous users that have searched for the same terms.
    - And more to come !
- **And many of our users' RFCs !**

    There are now many people using ElasticSuite and we are very happy to see this ! **Feel free to share you RFCs** with us by submitting issues !

Documentation
-------------

[](#documentation)

Documentation is available [here](https://github.com/Smile-SA/elasticsuite/wiki).

The User Guide is also available on PDF format [here](doc/static/User%20Guide-ElasticSuite%20for%20Magento%202-v2.6.pdf)

Standards &amp; Code Quality
----------------------------

[](#standards--code-quality)

Built on top of Magento2, our module respects all its prerequisites and code quality rules.

You can also find our PHPCS Standards and PHPMD rulesets in the **Resource** directory.

The module is also continuously tested on :

ToolsResultsCode Climate[![Code Climate](https://camo.githubusercontent.com/6fddcd98d9f8a3f8db595734cd60d1f44df579bf48a7e41448f3c9d845ce7269/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f536d696c652d53412f656c617374696373756974652f6261646765732f6770612e737667)](https://codeclimate.com/github/Smile-SA/elasticsuite)

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 60.3% of commits — single point of failure

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 ~17 days

Total

99

Last Release

2034d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/35364f9bf8e8af76953238d28f15a7d4d027746288de830e1fa5db551cdeedd6?d=identicon)[maximgubar](/maintainers/maximgubar)

---

Top Contributors

[![romainruaud](https://avatars.githubusercontent.com/u/15340849?v=4)](https://github.com/romainruaud "romainruaud (875 commits)")[![afoucret](https://avatars.githubusercontent.com/u/529238?v=4)](https://github.com/afoucret "afoucret (328 commits)")[![rbayet](https://avatars.githubusercontent.com/u/2353374?v=4)](https://github.com/rbayet "rbayet (126 commits)")[![androshchuk](https://avatars.githubusercontent.com/u/5081718?v=4)](https://github.com/androshchuk "androshchuk (56 commits)")[![replacementchicken](https://avatars.githubusercontent.com/u/42866750?v=4)](https://github.com/replacementchicken "replacementchicken (11 commits)")[![sambolek](https://avatars.githubusercontent.com/u/5627631?v=4)](https://github.com/sambolek "sambolek (6 commits)")[![amenk](https://avatars.githubusercontent.com/u/1087128?v=4)](https://github.com/amenk "amenk (5 commits)")[![robjstanley](https://avatars.githubusercontent.com/u/1289058?v=4)](https://github.com/robjstanley "robjstanley (5 commits)")[![shochdoerfer](https://avatars.githubusercontent.com/u/596449?v=4)](https://github.com/shochdoerfer "shochdoerfer (4 commits)")[![DanieliMi](https://avatars.githubusercontent.com/u/31039652?v=4)](https://github.com/DanieliMi "DanieliMi (3 commits)")[![maximgubar](https://avatars.githubusercontent.com/u/2241775?v=4)](https://github.com/maximgubar "maximgubar (3 commits)")[![Swahjak](https://avatars.githubusercontent.com/u/4386577?v=4)](https://github.com/Swahjak "Swahjak (3 commits)")[![elvinristi](https://avatars.githubusercontent.com/u/3975860?v=4)](https://github.com/elvinristi "elvinristi (3 commits)")[![vo1](https://avatars.githubusercontent.com/u/2106368?v=4)](https://github.com/vo1 "vo1 (2 commits)")[![southerncomputer](https://avatars.githubusercontent.com/u/6178967?v=4)](https://github.com/southerncomputer "southerncomputer (2 commits)")[![superdav42](https://avatars.githubusercontent.com/u/1534605?v=4)](https://github.com/superdav42 "superdav42 (2 commits)")[![Todep](https://avatars.githubusercontent.com/u/50146554?v=4)](https://github.com/Todep "Todep (2 commits)")[![Karlasa](https://avatars.githubusercontent.com/u/5417554?v=4)](https://github.com/Karlasa "Karlasa (2 commits)")[![rvitaliy](https://avatars.githubusercontent.com/u/1823711?v=4)](https://github.com/rvitaliy "rvitaliy (1 commits)")[![PascalNoisette](https://avatars.githubusercontent.com/u/2127862?v=4)](https://github.com/PascalNoisette "PascalNoisette (1 commits)")

---

Tags

searchgraphqlelasticsearchmagentocoremerchandisingmagento2setup

### Embed Badge

![Health badge](/badges/drinks-it-smile-elasticsuite/health.svg)

```
[![Health](https://phpackages.com/badges/drinks-it-smile-elasticsuite/health.svg)](https://phpackages.com/packages/drinks-it-smile-elasticsuite)
```

###  Alternatives

[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8044.5M33](/packages/smile-elasticsuite)[smile/module-elasticsuite-cms-search

Smile Elasticsuite - Cms Pages Search Module for Smile Elasticsuite.

25916.7k1](/packages/smile-module-elasticsuite-cms-search)[sehrling/elasticsuite-ghost-cleaner

Magento 2 module to delete ghost indices automatically for the Smile Elasticsuite module

1789.0k](/packages/sehrling-elasticsuite-ghost-cleaner)[mollie/magento2

Mollie Payment Module for Magento 2

1121.6M10](/packages/mollie-magento2)[swissup/module-search-mysql-legacy

Legacy mysql search for magento 2.4

10483.0k](/packages/swissup-module-search-mysql-legacy)[smile/elasticsuite-for-retailer

Smile ElasticSuite for Retailers - Magento2 toolkit for Retailers : Store Locator, Availability and Prices per store, etc...

18235.4k](/packages/smile-elasticsuite-for-retailer)

PHPackages © 2026

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