Skip to content

Realtime

Without Realtime, your app finds out about a new message when the member asks it to. With Realtime, the server tells the app something changed and the app fetches it.

The screens where waiting is most obvious:

  • Chat — a message arrives while the thread is open, instead of on the next refresh.
  • News feed and activity — new posts appear without a pull.
  • Notifications — the unread badge updates as it happens.

The service carries signals, not content. When something changes, your app receives a short message saying so, and then fetches the actual data from your WordPress site over the normal API.

That is a deliberate design rather than an implementation detail:

  • Your content never passes through the realtime service, so it holds no copy of your members’ messages.
  • Permissions are enforced by your site, on the fetch, exactly as they are everywhere else. A signal cannot leak something the member could not already read.
  • A dropped connection costs freshness, never correctness. The app falls back to refreshing as it would without the service.
  1. Choose a plan at Realtime in the builder.
  2. Authorise your site — see Authorising a site.
  3. Enable the Realtime endpoint group under Memberside → REST API.

Step three is easy to miss. Realtime is an endpoint group like any other, and it is off until you switch it on.

Clients reconnect with jitter — a small random delay before retrying — so that a brief service interruption does not produce every app in your community reconnecting at the same instant. Nothing to configure; worth knowing if you are watching your own server logs after an outage.

It does not make your site faster. Every screen still reads from your WordPress install at the same speed. Realtime changes when the app knows to read, not how long reading takes.

If your problem is that screens are slow rather than stale, look at Site Health instead.

SymptomCauseFix
Messages still only arrive on refreshThe Realtime endpoint group is offEnable it under Memberside → REST API
Realtime works for some members onlyTheir app is an older buildRebuild and redistribute
It stopped after a whileThe connection dropped and is backing offIt reconnects on its own; the app still refreshes normally
The site will not authoriseThe handshake was not completedAuthorising a site