Sign up

Realtime on every site you build.

WPSignal is a hosted WebSocket relay for WordPress. Install WordSocket on a client site, add ShopSocket for live orders and stock, or publish your own events from any hook. Nothing to host.

Getting Started

<Simple />

Installation

Download:
WP CLI:
Terminal 
wp plugin install wordsocket --activate
Composer:
Terminal 
composer require wpackagist-plugin/wordsocket

<Capabilities />

Built for WordPress developers

  • WebSocket-first

    Persistent WebSocket connections with Server-Sent Events as automatic fallback. Keepalive pings every 20 seconds.

    WP SITE PUBLISH RELAY WPSignal CLIENT CLIENT CLIENT

  • HMAC-signed publishes

    Every event is signed with SHA-256 HMAC. Timestamp replay protection and per-site rate limiting built in.

    PAYLOAD TIMESTAMP replay guard · SITE_SECRET HMAC SHA-256 a3f7 9c1e b82d SIG

  • Blind relay encryption

    On sites served over HTTPS, WordSocket encrypts event payloads with AES-256-GCM before they leave WordPress, so WPSignal relays ciphertext it cannot read.

    PLAINTEXT RAND·IV 12 bytes ENCRYPT·KEY AES·256 GCM dGhp c2lz dGVz CIPHER

  • Explorer

    Built-in admin page showing connection status, live event log, publish form, and token inspector for instant debugging.

    WP·ADMIN CONNECTED EXPLORER post.updated 14ms order.paid 6ms user.login 11ms comment.new 2ms PUBLISH events post.updated LIVE 1 client · 1 ch TOKEN site_id channels exp EVENTS post.updated order.paid user.login

<Code />

Example

Readable, developer focused API

on any WordPress action hook using the fluent builder API. Add a condition, custom channel, or transform the payload: all optional.

Listen for events

The browser client auto-connects and dispatches native CustomEvents, listen with plain JavaScript or integrate with any frontend framework.

See the full guide
wp-content/plugins/{plugin}/plugin.php 
add_action('wpsignal_loaded', function () {
  WPS::trigger('order.status_changed')
    ->on('woocommerce_order_status_changed', 10, 3)
    ->channel('events')
    ->data(
      fn ($order_id, $old_status, $new_status) => [
        'order_id' => $order_id,
        'old_status' => $old_status,
        'new_status' => $new_status,
        'total' => $order->get_total(),
      ])
    ->register();
});
wp-content/plugins/{plugin}/src/main.js 
document.addEventListener('wpsignal:order.status_changed', (e) => {
  const { 
    order_id, 
    new_status, 
    total 
  } = e.detail.data;
  triggerFlashNotification(order_id, new_status, total);
});

<What's next />

On the roadmap

WPSignal is actively developed. Here's what's planned next.

  1. WordPress RTC Integration

    Complete

    A WebSocket sync provider for Gutenberg's real-time collaboration, powered by Yjs.

  2. WP Plugin Repository Submission

    Complete

    WordSocket is live on the WordPress.org plugin directory. Install it directly from WP Admin or via WP-CLI.

  3. ShopSocket WordPress Plugin Submission

    In progress

    ShopSocket is a WordPress plugin that adds realtime overview of shoppers on your WooCommerce store and inventory updates to your users.

  4. E2E Encryption

    Planned

    Event payloads are already encrypted before they leave WordPress over HTTPS, so the relay forwards ciphertext it cannot read. Per-user end-to-end encryption is planned.

  5. Federation

    Planned

    Interconnected sites where messages are received by all or specific sites.

  6. Shared Worker (Connection Multiplexing)

    Planned

    Allow multiple single user connections to be multiplexed through a single shared worker.

Ready to go realtime?

Free during beta. No credit card required. Sign up, connect your site, and push your first event in minutes.

Get started free Getting started guide