PHPackages                             10up/elasticpress - 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. 10up/elasticpress

ActiveWordpress-plugin[Search &amp; Filtering](/categories/search)

10up/elasticpress
=================

Supercharge WordPress with Elasticsearch.

5.3.3(1mo ago)1.3k395.7k↓26.4%324[67 issues](https://github.com/10up/ElasticPress/issues)[31 PRs](https://github.com/10up/ElasticPress/pulls)7GPL-2.0-onlyPHPPHP &gt;=7.4CI passing

Since Jun 27Pushed 3d ago89 watchersCompare

[ Source](https://github.com/10up/ElasticPress)[ Packagist](https://packagist.org/packages/10up/elasticpress)[ RSS](/packages/10up-elasticpress/feed)WikiDiscussions develop Synced 3d ago

READMEChangelog (10)Dependencies (27)Versions (205)Used By (7)

ElasticPress
============

[](#elasticpress)

> A fast and flexible search and query engine for WordPress.

[![Support Level](https://camo.githubusercontent.com/cdb2c85978e766f367f2c6c66df441ea5f2843d2e3568d4113c2210e992d3ce2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737570706f72742d6163746976652d677265656e2e737667)](#support-level) [![Tests Status](https://github.com/10up/ElasticPress/actions/workflows/test.yml/badge.svg?branch=develop)](https://github.com/10up/ElasticPress) [![Release Version](https://camo.githubusercontent.com/65720f1e68e486ddc1a5304206cc926d6edcaa99184fee3c0acd14aebeefcb45/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f313075702f456c617374696350726573732e737667)](https://github.com/10up/ElasticPress/releases/latest) [![WordPress tested up to version](https://camo.githubusercontent.com/c770f9badebc16c35bb9e66e70d7b21feaf4371fb29d3e788efb115c78e7c69f/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f7465737465642f656c617374696370726573733f6c6162656c3d576f72645072657373)](https://camo.githubusercontent.com/c770f9badebc16c35bb9e66e70d7b21feaf4371fb29d3e788efb115c78e7c69f/68747470733a2f2f696d672e736869656c64732e696f2f776f726470726573732f706c7567696e2f7465737465642f656c617374696370726573733f6c6162656c3d576f72645072657373) [![MIT License](https://camo.githubusercontent.com/2712a8208481bf5df0714afe8245e7a47cc1817c5b578b169767ba3f35ea29d5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f313075702f456c617374696350726573732e737667)](https://github.com/10up/ElasticPress/blob/develop/LICENSE.md)

- Check out the [ElasticPress Docs](https://www.elasticpress.io/documentation/)

**Please note:** as of ElasticPress 4.0.0 `trunk` is the stable branch, built assets were removed from the `develop` branch, a ZIP with the plugin and its built assets are available on the [GitHub Releases page](https://github.com/10up/ElasticPress/releases), and will include a build script should you want to build assets from a branch. As such, please ensure you have updated any references you have from `master` to `trunk` or to GitHub releases depending on whether you require built assets or not.

Overview
--------

[](#overview)

ElasticPress, a fast and flexible search and query engine for WordPress, enables WordPress to find or “query” relevant content extremely fast through a variety of highly customizable features. WordPress out-of-the-box struggles to analyze content relevancy and can be very slow. ElasticPress supercharges your WordPress website making for happier users and administrators. The plugin even contains features for popular plugins.

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

[](#documentation)

- [Support site with FAQs, tutorials, and docs ☞](https://www.elasticpress.io/documentation/)
- [Security Policy ☞](https://github.com/10up/ElasticPress/blob/develop/SECURITY.md)

Requirements and Compatibility
------------------------------

[](#requirements-and-compatibility)

### Requirements

[](#requirements)

ElasticPress requires these software with the following versions:

- [Elasticsearch](https://www.elastic.co) 5.2+
- [WordPress](https://wordpress.org) 6.2+
- [PHP](https://php.net/) 7.4+

### Compatibility

[](#compatibility)

The WooCommerce feature is compatible with the last two major versions of the [WooCommerce plugin](https://wordpress.org/plugins/woocommerce/).

Building Assets
---------------

[](#building-assets)

Simply downloading the repository files is not enough to have the plugin working, as CSS and JavaScript files are built during the release process. If you want to use a development version of the plugin you will to run:

`npm install && npm run build`

[Node.js](https://nodejs.org/en/) (v20) and [npm](https://www.npmjs.com/) (v9) are required.

React Components
----------------

[](#react-components)

Interested in integrating ElasticPress in your headless WordPress website? Check out [ElasticPress React](https://github.com/10up/elasticpress-react).

Issues
------

[](#issues)

If you identify any errors or have an idea for improving the plugin, please [open an issue](https://github.com/10up/ElasticPress/issues?state=open). We're excited to see what the community thinks of this project, and we would love your input!

Support Level
-------------

[](#support-level)

**Active:** 10up is actively working on this, and we expect to continue work for the foreseeable future including keeping tested up to the most recent version of WordPress. Bug reports, feature requests, questions, and pull requests are welcome.

Changelog
---------

[](#changelog)

A complete listing of all notable changes to ElasticPress are documented in [CHANGELOG.md](https://github.com/10up/elasticpress/blob/develop/CHANGELOG.md).

Upgrade notices
---------------

[](#upgrade-notices)

### 3.5

[](#35)

**Search Algorithm Upgrade Notice:** Version 3.5 includes a revamp of the search algorithm. This is a backwards compatibility break. If you'd like to revert to the old search algorithm, you can use the following code: `add_filter( 'ep_search_algorithm_version', function() { return '3.4'; } );`. The new algorithm offers much more relevant search results and removes fuzziness which results in mostly unwanted results for most people. If you are hooking in and modifying the search query directly, it's possible this code might break and you might need to tweak it.

### 4.0.0

[](#400)

**Note that ElasticPress 4.0.0 release removes built assets from the `develop` branch, replaced `master` with `trunk`, added a ZIP with the plugin and its built assets in the [GitHub Releases page](https://github.com/10up/ElasticPress/releases), and included a build script should you want to build assets from a branch.** As such, please plan to update any references you have from `master` to `trunk` or to GitHub Releases depending on whether you require built assets or not.

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

[](#contributing)

Please read [CODE\_OF\_CONDUCT.md](https://github.com/10up/elasticpress/blob/develop/CODE_OF_CONDUCT.md) for details on our code of conduct, [CONTRIBUTING.md](https://github.com/10up/elasticpress/blob/develop/CONTRIBUTING.md) for details on the process for submitting pull requests to us, and [CREDITS.md](https://github.com/10up/elasticpress/blob/develop/CREDITS.md) for a listing of maintainers of, contributors to, and libraries used by ElasticPress.

Like what you see?
------------------

[](#like-what-you-see)

[![](https://camo.githubusercontent.com/5ec5223fa6fe20a5ca00d8d768bd7ee91e93f67c9d7a06e575c87e3ed1d00263/68747470733a2f2f313075702e636f6d2f75706c6f6164732f323031362f31302f313075702d4769746875622d42616e6e65722e706e67)](https://10up.com/contact/)

###  Health Score

74

—

ExcellentBetter than 100% of packages

Maintenance94

Actively maintained with recent releases

Popularity62

Solid adoption and visibility

Community48

Growing community involvement

Maturity83

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

Total

104

Last Release

57d ago

Major Versions

2.8.2 → 3.02019-05-13

3.6.5 → 4.0.0-beta.12021-12-08

3.6.6 → 4.0.02022-03-08

4.5.2 → 3384.x-dev2023-06-13

4.7.2 → 5.0.02023-11-01

PHP version history (5 changes)v1.3PHP &gt;=5.2

3.0PHP &gt;=5.4

3.0.3PHP &gt;=5.6

4.0.0PHP &gt;=7.0

5.0.0PHP &gt;=7.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3358927?v=4)[10up](/maintainers/10up)[@10up](https://github.com/10up)

![](https://avatars.githubusercontent.com/u/1844351?v=4)[Taylor Lovett](/maintainers/tlovett1)[@tlovett1](https://github.com/tlovett1)

---

Top Contributors

[![felipeelia](https://avatars.githubusercontent.com/u/184628?v=4)](https://github.com/felipeelia "felipeelia (3549 commits)")[![tlovett1](https://avatars.githubusercontent.com/u/1844351?v=4)](https://github.com/tlovett1 "tlovett1 (1695 commits)")[![JakePT](https://avatars.githubusercontent.com/u/4100733?v=4)](https://github.com/JakePT "JakePT (600 commits)")[![burhandodhy](https://avatars.githubusercontent.com/u/7139602?v=4)](https://github.com/burhandodhy "burhandodhy (572 commits)")[![Rahmon](https://avatars.githubusercontent.com/u/6010232?v=4)](https://github.com/Rahmon "Rahmon (477 commits)")[![oscarssanchez](https://avatars.githubusercontent.com/u/31049169?v=4)](https://github.com/oscarssanchez "oscarssanchez (408 commits)")[![petenelson](https://avatars.githubusercontent.com/u/1757075?v=4)](https://github.com/petenelson "petenelson (161 commits)")[![ZacharyRener](https://avatars.githubusercontent.com/u/28653493?v=4)](https://github.com/ZacharyRener "ZacharyRener (158 commits)")[![cmmarslender](https://avatars.githubusercontent.com/u/1915905?v=4)](https://github.com/cmmarslender "cmmarslender (155 commits)")[![dinhtungdu](https://avatars.githubusercontent.com/u/5423135?v=4)](https://github.com/dinhtungdu "dinhtungdu (144 commits)")[![brandwaffle](https://avatars.githubusercontent.com/u/663228?v=4)](https://github.com/brandwaffle "brandwaffle (117 commits)")[![rebeccahum](https://avatars.githubusercontent.com/u/16962021?v=4)](https://github.com/rebeccahum "rebeccahum (82 commits)")[![jeffpaul](https://avatars.githubusercontent.com/u/2818133?v=4)](https://github.com/jeffpaul "jeffpaul (74 commits)")[![christianc1](https://avatars.githubusercontent.com/u/5025568?v=4)](https://github.com/christianc1 "christianc1 (65 commits)")[![MARQAS](https://avatars.githubusercontent.com/u/15303814?v=4)](https://github.com/MARQAS "MARQAS (64 commits)")[![mlaroy](https://avatars.githubusercontent.com/u/3901457?v=4)](https://github.com/mlaroy "mlaroy (63 commits)")[![sc0ttkclark](https://avatars.githubusercontent.com/u/709662?v=4)](https://github.com/sc0ttkclark "sc0ttkclark (55 commits)")[![AaronHolbrook](https://avatars.githubusercontent.com/u/953022?v=4)](https://github.com/AaronHolbrook "AaronHolbrook (47 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (39 commits)")[![lukaspawlik](https://avatars.githubusercontent.com/u/7304218?v=4)](https://github.com/lukaspawlik "lukaspawlik (35 commits)")

---

Tags

elasticsearchhacktoberfestsearchwordpresswordpress-pluginwp-querypluginsearchwordpresselasticsearchelasticpress

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/10up-elasticpress/health.svg)

```
[![Health](https://phpackages.com/badges/10up-elasticpress/health.svg)](https://phpackages.com/packages/10up-elasticpress)
```

###  Alternatives

[10up/debug-bar-elasticpress

Extends the Debug Bar plugin for usage with ElasticPress

2917.5k](/packages/10up-debug-bar-elasticpress)[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[webdevstudios/cmb2-post-search-field

Custom field for CMB2 which adds a post-search dialog for searching/attaching other post IDs.

6648.5k2](/packages/webdevstudios-cmb2-post-search-field)[alleyinteractive/searchpress

Elasticsearch integration for WordPress.

851.0k1](/packages/alleyinteractive-searchpress)[kvz/elasticsearch

CakePHP Plugin for ElasticSearch

4410.5k](/packages/kvz-elasticsearch)

PHPackages © 2026

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