BLACK FRIDAY
Save 59% on PageForge Annual $191/year $485/year
Claim 59% Off →
HyperDB icon
Possibly abandoned Tested up to 6.0.16 #14 in availability

HyperDB

HyperDB is an advanced database class that supports replication, failover, load balancing, and partitioning.

Active installs10+10+ tier
Downloads · 30d882▼ -24.1% vs prev. 30d
Rating4.1/514 reviews
Health score31/100At risk
All-time downloads193.8KSince May 2016
Support resolved—No recent threads
RequiresWP 4.2PHP any
Downloads · 7d277▲ +31.9% week over week
Our verdict

Consider an alternative

HyperDB shows warning signs in 2026 — compare the alternatives below before installing. It runs on 10+ sites, is rated 4.1/5 and was last updated 4 years ago, and scores 31/100 on our health check.

  • Small user base (10+ active installs)
  • No update in 3 years
  • Only tested up to WordPress 6.0 (latest is 7.1)

How does it stack up?

Side-by-side on installs, updates, ratings & support

Daily downloads

316395Jun 30Aug 13Sep 27
Yesterday20
Daily average (1y)34
Peak day189Oct 14, 2025
Last 12 months12.3K

Download spikes usually follow a new release — each site that auto-updates counts as a download.

Rankings

Where HyperDB stands today

WordPress.org search rankings

Live position in the plugin search, top 100
KeywordPositionCompeting pluginsCategory
availability >100 2,377 Best availability plugins →
mysql >100 2,152 Best mysql plugins →
performance >100 10,000 Best performance plugins →
scaling >100 425 Best scaling plugins →
WordPress.com >100 449 Best WordPress.com plugins →

Version adoption

Share of active sites per release.

  • 1.8100.0%

Rating breakdown

★★★★★★★★★★ 4.1 from 14 reviews

  • 5★78.6%
  • 4★0.00%
  • 3★0.00%
  • 2★0.00%
  • 1★21.4%

About HyperDB

From the official readme · v1.8

Description

HyperDB is a very advanced database class that replaces a few of the WordPress built-in database functions. The main differences are:
* HyperDB can be connect to an arbitrary number of database servers,
* HyperDB inspects each query to determine the appropriate database.

It supports:

  • Read and write servers (replication)
  • Configurable priority for reading and writing
  • Local and remote datacenters
  • Private and public networks
  • Different tables on different databases/hosts
  • Smart post-write master reads
  • Failover for downed host
  • Advanced statistics for profiling
  • WordPress Multisite

It is based on the code currently used in production on WordPress.com with many MySQL servers spanning multiple datacenters.

Installation

Nothing goes in the plugins directory.

  1. Enter a configuration in db-config.php.

  2. Deploy db-config.php in the directory that holds wp-config.php. This may be the WordPress root or one level above. It may also be anywhere else the web server can see it; in this case, define DB_CONFIG_FILE in wp-config.php.

  3. Deploy db.php to the /wp-content/ directory. Simply placing this file activates it. To deactivate it, move it from that location or move the config file.

Any value of WP_USE_MULTIPLE_DB will be ignored by HyperDB.

Frequently asked questions

What can I do with HyperDB that I can’t do with WPDB?

WordPress.com, the most complex HyperDB installation, manages millions of tables spanning thousands of databases. Dynamic configuration logic allows HyperDB to compute the location of tables by querying a central database. Custom scripts constantly balance database server resources by migrating tables and updating their locations in the central database. Stretch your imagination. You could create a dynamic configuration using persistent caching to gather intelligence about the state of the network. The only constant is the name of the configuration file. The rest, as they say, is PHP.

How does HyperDB support replication?

HyperDB does not provide replication services. That is done by configuring MySQL servers for replication. HyperDB can then be configured to use these servers appropriately, e.g. by connecting to master servers to perform write queries.

How does HyperDB support load balancing?

HyperDB randomly selects database connections from priority groups that you configure. The most advantageous connections are tried first. Thus you can optimize your configuration for network topology, hardware capability, or any other scheme you invent.

How does HyperDB support failover?

Failover describes how HyperDB deals with connection failures. When HyperDB fails to connect to one database, it tries to connect to another database that holds the same data. If replication hasn’t been set up, HyperDB tries reconnecting a few times before giving up.

How does HyperDB support partitioning?

HyperDB allows tables to be placed in arbitrary databases. It can use callbacks you write to compute the appropriate database for a given query. Thus you can partition your site’s data according to your own scheme and configure HyperDB accordingly.

Is there any advantage to using HyperDB with just one database server?

None that has been measured. HyperDB does at least try again before giving up connecting, so it might help in cases where the web server is momentarily unable to connect to the database server. One way HyperDB differs from WPDB is that HyperDB does not attempt to connect to a database until a query is made. Thus a site with sufficiently aggressive persistent caching could remain read-only accessible despite the database becoming unreachable.

What if all database servers for a dataset go down?

Since HyperDB attempts a connection only when a query is made, your WordPress installation will not kill the site with a database error, but will let the code decide what to do next on an unsuccessful query. If you want to do something different, like setting a custom error page or kill the site, you need to define the ‘db_connection_error’ callback in your db-config.php.

Changelog

1.9

  • Restore the behavior where we retry failed connection attempts to masters;
  • Unbreak the logic for marking servers as down – in r2625068 the key for marking server as down was mistakenly changed to “server_readonly_$host$port” instead of “server_state_$host$port”
  • If all masters are marked as read-only, ignore the read-only flag and still try to connect; otherwise we might end up incorrectly breaking the master connections for 2 minutes (APCu cache time) if we had temporarily set read-only on them;
  • Fix a bug where having $dbhname in the server state keys can delay marking server as down or read_only by doing it once for all possible datasets and operations instead of once for the host+port;
  • Fix a bug where we could mark server as read-only even though the ER_OPTION_PREVENTS_STATEMENT error was returned for a different reason; now we match to make sure we actually have ‘read-only’ in the returned error;
  • Fix a bug where the correct tracking of the unique read-only servers or lagged slaves might fail if we have duplicate servers for the same dataset;
  • Fix a bug where we would not mark masters as read-only in HyperDB if they were set read-only on the server side after we already opened a connection;
  • Fix a bug where we might stop respecting the minimum configured amount of retries per dataset;
  • Revert the persistent unused_servers logic which was added in HyperDB 1.8 because: it can cause connection failures when the available servers are exhausted, we might use servers with wrong priorities, and not see newly added servers to HyperDB. Some examples of conditions which would trigger these behaviors include: server-side disconnects on timeout; when we manually disconnect open connections in long-running scripts; when we switch between different datasets on the same remote MySQL server; we’ve gone over the configured max_connections and started disconnecting existing connections to accomodate new ones;
  • Make sure the read_only and the downed logic still works in environments which don’t have APCu or APCu is badly fragmented by adding local caching
  • Correct the dbh property type
  • PHP 8.0 compatibility for call_user_func_array() and db_connections attribute

1.8

  • Support for fallback master connections
  • Add support for marking servers read-only
  • Fix the issue when do_action() is not available
  • Use APCu to cache the results of server responsiveness
  • Add support for the utf8mb4 server capability

1.7

  • Add support for information_schema and transactions
  • Requires WordPress 4.2 for wpdb::get_table_from_query()

1.6

  • Add support for MYSQL_CLIENT_FLAGS which was added to wpdb in [21609]
  • Fix PHP 7.3 Notice

1.5

  • Fix WordPress 4.8.3 SQLi vulnerability
  • Add action for SQL logging
  • Never db_connect for SELECT FOUND_ROWS()
  • Better cleanup when disconnecing db connections

1.4

  • Additional logging for HyperDB failures and do not save “null” queries.

Full changelog on WordPress.org →

For developers

Is this your plugin? Show off the numbers.

Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.

Active installs badge Rating badge Health score badge

Best HyperDB alternatives

All availability plugins →
Alternatives
Rank Plugin Active installs Rating Updated Health
1 Availability Datepicker – Booking Calendar for Contact Form 7 – Input WP Availability Datepicker Availability datepicker & booking calendar for any form. Configure business hours, time… by inputwp 10K+ ★★★★★★★★★★ 4.1 (42) 7 months ago 47
2 Booqable Rental Plugin Booqable Rental Plugin Booqable - WordPress Rental Plugin by Booqable Rental Software 1K+ ★★★★★★★★★★ 4.2 (10) 4 months ago 57
3 Twice Commerce – Easy Rental Booking System Twice Commerce – Easy Rental Booking System Free rental and booking plugin for Wordpress websites by Twice Commerce. Reservations with… by Twice Commerce 300+ ★★★★★★★★★★ 5 (2) 4 months ago 61
4 Bukza Bukza Flexible Online Booking Tools. Reservation System for Services, Rentals and Events. by Bukza 200+ ★★★★★★★★★★ 5 (2) 1 month ago 72
5 Wishlist and Waitlist for WooCommerce Wishlist and Waitlist for WooCommerce Wishlist and Waitlist for your clients by BeRocket 100+ ★★★★★★★★★★ 3.9 (7) 1 month ago 72
6 eZee Online Hotel Booking Engine eZee Online Hotel Booking Engine eZee Reservation plugin is solutions for hotel, resorts, B&B, hotel chains, to get… by eZee Technosys 100+ ★★★★★★★★★★ 2.3 (6) 7 years ago 26
7 DoBu.uk Availability DoBu.uk Availability Embed DoBu.uk availability and booking calendars by Richard Palethorpe 100+ ★★★★★★★★★★ 5 (1) 4 years ago 32
8 Super Monitoring Super Monitoring Monitor your website uptime and basic functions with www.supermonitoring.com and access… by siteimpulse 60+ ★★★★★★★★★★ 4.4 (9) 4 months ago 63
9 Circumflex Booking Circumflex Booking Flexible appointment booking with manual approval, service selection, and email… by sutregutt 50+ ★★★★★★★★★★ No reviews 5 days ago 68
10 Icalviz Icalviz Show your real-time Google Calendar availability as a beautiful front-end calendar — no API… by Killian Santos 40+ ★★★★★★★★★★ No reviews 5 months ago 45

FAQ

HyperDB: quick answers

Straight answers, pulled from live WordPress.org data.

Live data from WordPress.org · checked Sep 28, 2026

Is HyperDB free?

Yes. HyperDB is free to download and use from the official WordPress.org plugin directory.

Is HyperDB safe to use in 2026?

HyperDB shows warning signs in 2026 — compare the alternatives below before installing. It runs on 10+ sites, is rated 4.1/5 and was last updated 4 years ago, and scores 31/100 on our health check.

How many websites use HyperDB?

HyperDB is active on 10+ WordPress websites and has been downloaded 193,840 times since it launched in May 2016. It was downloaded 882 times in the last 30 days.

Does HyperDB work with WordPress 7.1?

HyperDB is officially tested up to WordPress 6.0.16, while the latest release is 7.1.2. It may still work, but try it on a staging site first.

When was HyperDB last updated?

The latest version, 1.8, was released on October 12, 2022 (4 years ago).

Who makes HyperDB?

HyperDB is developed and maintained by Automattic.

What are the best alternatives to HyperDB?

The most popular alternatives to HyperDB are Availability Datepicker (10K+ installs), Booqable Rental Plugin (1K+ installs) and Twice Commerce (300+ installs).

Powered by PageForge

Want thousands of pages that rank like these? Build them in an afternoon.

This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.

  • CSV, Google Sheets & API data sources
  • AI content, schema & internal links per page
  • Works with Elementor, Gutenberg, Yoast & Rank Math
  • Free on WordPress.org — no credit card
Sarah is here to help!
Hi there! 👋 Need help finding what you're looking for?
Sarah
Sarah
Online & Ready to Help
Hi there! 👋 Need help finding what you're looking for?

We'll use this to continue our conversation

Just now ✓ Verified

Join 500+ SEO Pros Scaling Their Strategy

Get exclusive programmatic SEO tactics, AI content workflows, and the latest PageForge updates delivered straight to your inbox. Stay ahead of the algorithm.

We care about your data in our privacy policy.