Title: Presence API
Author: WordPress.org
Published: <strong>July 21, 2026</strong>
Last modified: July 21, 2026

---

Search plugins

![](https://ps.w.org/presence-api/assets/banner-772x250.png?rev=3617907)

![](https://ps.w.org/presence-api/assets/icon.svg?rev=3617894)

# Presence API

 By [WordPress.org](https://profiles.wordpress.org/wordpressdotorg/)

[Download](https://downloads.wordpress.org/plugin/presence-api.0.1.4.zip)

 * [Details](https://wordpress.org/plugins/presence-api/#description)
 * [Reviews](https://wordpress.org/plugins/presence-api/#reviews)
 *  [Installation](https://wordpress.org/plugins/presence-api/#installation)
 * [Development](https://wordpress.org/plugins/presence-api/#developers)

 [Support](https://wordpress.org/support/plugin/presence-api/)

## Description

Tracks which users are logged in, what admin screen they are viewing, and which 
posts are being edited. Uses a dedicated database table with a 60-second TTL. Data
flows through the existing Heartbeat API.

For full details, see the [GitHub repository](https://github.com/WordPress/presence-api).

## Installation

 1. Upload the plugin to the `/wp-content/plugins/` directory.
 2. Activate through the “Plugins” menu in WordPress.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Presence API” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/)
 *   [ Joe Fusco ](https://profiles.wordpress.org/joefusco/)

[Translate “Presence API” into your language.](https://translate.wordpress.org/projects/wp-plugins/presence-api)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/presence-api/), check
out the [SVN repository](https://plugins.svn.wordpress.org/presence-api/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/presence-api/) by
[RSS](https://plugins.trac.wordpress.org/log/presence-api/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.1.4

 * Auto-sync readme.txt changelog from CHANGELOG.md in sync-versions.sh.

#### 0.1.3

 * Add 40-user Playground blueprint.
 * Add 40-user Playground blueprint (down from 100).
 * Address stale-screen review feedback.
 * Address WordPress.org plugin review feedback.
 * Close wp_presence_current_screen_key() brace dropped by autofix.

#### 0.1.2

 * Add WordPress Playground blueprint for one-click testing.
 * Remove demo CLI command from production builds.
 * Split CI into separate PHPCS, PHPUnit, and Multisite workflows.
 * Exclude vendor directory from release zip.
 * Add readme.txt for WordPress.org directory submission.
 * Add WordPress.org repository compliance files (CONTRIBUTING, CODEOWNERS, CODE_OF_CONDUCT).
 * Move community health files to .github/.
 * Replace deprecated get_page_by_title() with WP_Query.
 * Add ABSPATH guards to db-viewer.php and demo-seeder.php.
 * Exclude .claude directory from release zip.

#### 0.1.1

 * Fix Plugin Check errors for directory submission.

#### 0.1.0

 * Dedicated `wp_presence` table with `UNIQUE KEY (room, client_id)` for atomic 
   upserts via `INSERT ... ON DUPLICATE KEY UPDATE`.
 * 60-second TTL with batched cron cleanup.
 * Public API: `wp_get_presence`, `wp_set_presence`, `wp_remove_presence`, `wp_remove_user_presence`,`
   wp_can_access_presence_room`, `wp_presence_post_room`.
 * REST endpoints: `GET/POST/DELETE /wp-presence/v1/presence`, `GET /wp-presence/
   v1/presence/rooms` with SQL pagination and `Cache-Control: no-store`.
 * Heartbeat integration for admin and editor presence pings.
 * Post-lock bridge: translates `wp-refresh-post-lock` into presence entries.
 * Login/logout lifecycle hooks gated on `edit_posts`.
 * Dashboard widgets: Who’s Online (with idle detection, overflow threshold, avatar
   stacks) and Active Posts (grouped by post with editor counts).
 * Admin bar indicator: avatar stack for same-page users, dropdown grouped by “On
   this page” / “Elsewhere”, alphabetically sorted.
 * Post list “Editors” column with avatar stacks.
 * Users list “Online” filter tab.
 * WP-CLI: `set`, `list`, `summary`, `cleanup`.
 * Debugger widget (WP_DEBUG only): heartbeat monitor with live table viewer.
 * `wp_presence_default_ttl` filter and `WP_PRESENCE_DEFAULT_TTL` constant.
 * Multisite-aware `uninstall.php`.
 * Full i18n with `.pot` file.
 * WCAG AA accessibility: ARIA labels, `aria-live`, keyboard navigation.
 * 59 PHPUnit tests, 118 assertions.
 * Playwright e2e tests with screenshot artifacts.

## Community plugin

This plugin is developed and supported by a community.

## Meta

 *  Version **0.1.4**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 7.0 or higher **
 *  Tested up to **7.0.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [awareness](https://wordpress.org/plugins/tags/awareness/)[heartbeat](https://wordpress.org/plugins/tags/heartbeat/)
   [presence](https://wordpress.org/plugins/tags/presence/)[real-time](https://wordpress.org/plugins/tags/real-time/)
 *  [Advanced View](https://wordpress.org/plugins/presence-api/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/presence-api/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/presence-api/reviews/)

## Contributors

 *   [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/)
 *   [ Joe Fusco ](https://profiles.wordpress.org/joefusco/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/presence-api/)