elasticsuite codeclimate eslint travis-ci Packagist

Smile ElasticSuite - Magento 2 Merchandising built on ElasticSearch



⚠️ Magento versions compatibility :

We had a lot of work on Magento 2.1.x compatibility since there was a lot of compatibility breaking changes in this version (introduction of the entity manager, new form based on UI components, staging for the EE edition, …).

The migration is now finished concerning both CE and EE versions.

If your project is based on Magento 2.1.x you can start working with ElasticSuite today using the latest 2.2.1 release.

Which version should I use ?

Magento Version ElasticSuite Latest Version
Magento 2.0.* CE / EE ElasticSuite 2.1.1 release
Magento 2.1.* CE / EE ElasticSuite 2.2.1 release

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.

Who is developping ElasticSuite ?


SmileLab is the innovation and experimentation department of Smile. Smile is the European leader of Open Source and also a four-times Europe Partner of the the Year (2010-2014) and two-times Spirit of Excellence (2015-2016) 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 ?

A demonstration store including the latest version of ElasticSuite is available here : ElasticSuite Demo

Main Features

Current version

The current version 2.2.0 has been focused on the Magento 2.1 compatibility.

This version features a full Staging Compatibility and can be used without issues on Magento Enterprise Edition 2.1.x.

From now, we are working on the migration of all features available into the Magento 1.x .version of the module in this new version.

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

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

  • 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

  • Product & Categories autocomplete :

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

    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 about adding custom content into the autocomplete results.

    Products Autocomplete

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


    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.


    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”).

  • Enhanced price slider :

    The module features an out of the box price slider.

    Price Slider

  • Multiple select in layered navigation :

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

    Multi Select Facet

  • Multiple select for swatches :

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

    Multi Select Swatches

  • 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

  • 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

  • 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

And more to come !

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

  • Even richer autocomplete :

    We plan to add very soon into the autocomplete results : Products attributes (eg : product brand, authors for a book, actors for DVDs, etc…).

  • Search optimizations :

    ElasticSuite will also feature several ways to optimize the search engine relevance. This part will again be based on rules that can be defined in the Magento’s back-office. This will allow you to create rules like “Boost all products that are in stock” or “Boost all new products”. A preview for all optimizer rules will be available in the back-office so that you will be able to preview each fine-tuning before publishing it. This part of the module will be fully customizable and extensible for all your needs.

    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 is available here.

The User Guide is also available on PDF format here

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 :

Tools Results
Code Climate Code Climate

Related Repositories



Smile ElasticSuite - Magento 2 Merchandising built on ElasticSearch ...



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

Top Contributors

afoucret romainruaud Fdec robjstanley googlygoo vo1 jreinke PascalNoisette


-   2.2.4 zip tar
-   2.2.3 zip tar
-   2.2.2 zip tar
-   2.2.1 zip tar
-   2.2.0 zip tar
-   2.2.0-alpha2 zip tar
-   2.2.0-alpha1 zip tar
-   2.1.3 zip tar
-   2.1.2 zip tar
-   2.1.1 zip tar
-   2.1.0 zip tar
-   2.0.0 zip tar