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.2.2(1mo ago)1.3k374.3k↑12.7%321[6 issues](https://github.com/10up/ElasticPress/issues)[20 PRs](https://github.com/10up/ElasticPress/pulls)5GPL-2.0-onlyPHPPHP &gt;=7.4CI passing

Since Jun 27Pushed 2mo ago91 watchersCompare

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

READMEChangelog (10)Dependencies (18)Versions (198)Used By (5)

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

72

—

ExcellentBetter than 100% of packages

Maintenance88

Actively maintained with recent releases

Popularity62

Solid adoption and visibility

Community44

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

Recently: every ~35 days

Total

103

Last Release

54d 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://www.gravatar.com/avatar/751617bbe2cea3a8d32f79403d174807b22ab2f806fd1cee6705d21b73746c97?d=identicon)[tlovett1](/maintainers/tlovett1)

---

Top Contributors

[![felipeelia](https://avatars.githubusercontent.com/u/184628?v=4)](https://github.com/felipeelia "felipeelia (3520 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 (570 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)")[![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)")[![ZacharyRener](https://avatars.githubusercontent.com/u/28653493?v=4)](https://github.com/ZacharyRener "ZacharyRener (127 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

[elasticsearch/elasticsearch

PHP Client for Elasticsearch

5.3k178.3M943](/packages/elasticsearch-elasticsearch)[10up/debug-bar-elasticpress

Extends the Debug Bar plugin for usage with ElasticPress

2917.0k](/packages/10up-debug-bar-elasticpress)[jolicode/elastically

Opinionated Elastica based framework to bootstrap PHP and Elasticsearch implementations.

2571.7M1](/packages/jolicode-elastically)[webdevstudios/cmb2-post-search-field

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

6647.7k2](/packages/webdevstudios-cmb2-post-search-field)[cmsig/seal

Search Engine Abstraction Layer

32207.9k53](/packages/cmsig-seal)[kvz/elasticsearch

CakePHP Plugin for ElasticSearch

4410.5k](/packages/kvz-elasticsearch)

PHPackages © 2026

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