BACK TO DIRECTORY

Presence API

by WordPress.org

0.0
(0 ratings)

Presence API gives WordPress a system-wide awareness layer. It tracks which users are logged in, which admin screen they are on, and which posts they are editing.

Data flows through the Heartbeat API and is stored in a dedicated wp_presence table with a 150-second TTL. No writes to wp_postmeta means no post-cache invalidation on every heartbeat.

On a multisite network, Network Admin gets its own view of the same data: a Who’s Online dashboard widget listing the busiest sites and who is on each, an Online column in the Sites list, and an Online view, filter, and column in the Users list. These require the manage_network capability.

Features

  • Admin bar indicator showing who’s online and who’s on this page
  • Active Posts dashboard widget grouped by post
  • Editors column in the post list
  • A notice on synced patterns in the block editor while someone else is editing them
  • Online filter in the Users list
  • A notice when someone else saves the screen you have open
  • Post locks kept in the presence table instead of post meta, so holding a lock no longer makes cached post queries stale
  • A switch for each feature on Settings > Presence API
  • AI agents labelled in the admin bar, the Active Posts widget, and the Editors column, once a plugin such as Agent Users marks them

For Developers

PHP functions, REST endpoints, WP-CLI commands, filters, and room conventions are documented in the GitHub repository.

Background

A feature plugin sponsored by the WordPress Core team, exploring what system-wide presence could look like for a future WordPress release. Follow development on make.wordpress.org/core with the tag #presence-api.

Screenshots

The dashboard with 101 people online, the admin bar's presence menu open, and Active Posts listing who is editing each post and page.

The dashboard with 101 people online, the admin bar's presence menu open, and Active Posts listing who is editing each post and page.

The Posts list, with an Editors column showing who has each post open.

The Posts list, with an Editors column showing who has each post open.

The Users list filtered to the people online right now.

The Users list filtered to the people online right now.

The notice someone sees when another person saves the settings screen they have open.

The notice someone sees when another person saves the settings screen they have open.

Settings > Presence API, where a site switches features off.

Settings > Presence API, where a site switches features off.

Network Admin's Who's Online widget, listing the busiest sites and how many people are on each.

Network Admin's Who's Online widget, listing the busiest sites and how many people are on each.

Plugin Details

Active Installs
10
Total Downloads
5,865
Version
0.18.4
Requires WP
7.0
Requires PHP
7.4
Tested Up To
7.1.4
Added
2026-07-21
Last Updated
2026-10-26 5:58pm GMT

Ratings

5
0
4
0
3
0
2
0
1
0