Skip to main content

BuddyPress Messaging Plugin: Modern Private Chat for BuddyPress

· 5 min read
Andrij Tkachenko
Creator of Better Messages
info

Originally published when Better Messages 1.0 launched on WordPress.org in January 2017. This post has been kept up to date as the plugin matured — the body below describes the BuddyPress integration as it works today. The original idea has not changed: replace BuddyPress's built-in messages with a modern real-time messenger.

BuddyPress is the open-source social community plugin for WordPress, powering communities, networks, and intranets. Better Messages replaces BuddyPress's built-in private messages with a modern messenger — real-time delivery, group conversations, file uploads, voice messages, voice and video calls, AI bots, end-to-end encryption, web push, and a native mobile app. It has become the de-facto messaging plugin for BuddyPress sites over the past several years.

This post explains what changes for a BuddyPress site once Better Messages is installed, how it integrates with BuddyPress Friends and Groups, and what stays the same.

What Better Messages adds to BuddyPress​

Once Better Messages is installed and Messages Location is set to Show in BuddyPress profile, all existing Messages links in BuddyPress point at the Better Messages inbox instead of the legacy component. From the user's perspective:

  • Real-time messages — new messages arrive without refreshing the page. With the WebSocket version, delivery is instant. With the free version, AJAX polling delivers within a few seconds.
  • Group conversations — proper group chats with shared history, not a broadcast to a list of recipients.
  • BuddyPress Friends integration — start a thread directly from the Friends list inside the messenger, or from any friend's profile.
  • BuddyPress Groups integration — every BuddyPress group can have a paired group chat. Members are auto-added when they join the BuddyPress group, and auto-removed when they leave.
  • File uploads, reactions, replies, edits, mentions, GIPHY, stickers — the standard set of modern messenger features.
  • Voice and video calls (WebSocket version) — one-on-one and group calls inside the chat.

Why a BuddyPress site needs a messaging upgrade​

Community sites live or die by how easily members talk to each other. BuddyPress's built-in messaging works, but it asks members to refresh a page to see a reply, breaks the conversation into a list of single messages, and offers no way to share an image or a file. For a site that wants members to stay engaged daily, that gap is the difference between a Slack-like experience and an old forum private-message system.

Better Messages does not require disabling BuddyPress's messages component — it transparently takes over the URLs that BuddyPress already uses, so members do not have to learn a new place to look.

Installing Better Messages on BuddyPress​

  1. Install Better Messages from WordPress.org and activate it.
  2. Open WP Admin → Better Messages → Settings → General.
  3. Set Messages Location to Show in BuddyPress profile (or to a dedicated WordPress page if you prefer a different URL).
  4. Save.

That is the entire setup. Every existing BuddyPress messages link now points at Better Messages.

BuddyPress Friends integration​

The friends integration is enabled by default. Inside the messenger sidebar, members see a Friends list pulled from BuddyPress Friends — no need to remember a username to start a thread.

BuddyPress Groups integration​

The groups integration creates an optional group chat for every BuddyPress group. Three things to know:

  • Group members are auto-added to the chat when they join the BuddyPress group.
  • Group members are auto-removed from the chat when they leave the BuddyPress group.
  • Group admins can pin the chat as a tab inside the BuddyPress group nav.

The group chat is a real group conversation: shared history, mentions, file uploads, the full feature set.

Free vs WebSocket version for BuddyPress communities​

FeatureFree (AJAX)WebSocket
BuddyPress profile, Friends, Groups integrationyesyes
Group conversations and file uploadsyesyes
Real-time deliverypollinginstant
One-on-one voice and video calls—yes
Group voice and video calls inside any thread—yes
Web push notifications for new messages—yes
Read receipts—yes
End-to-end encryption (optional)—yes

Frequently asked questions​

Does Better Messages replace the BuddyPress messages component or coexist with it?​

It takes over the same URLs, so members never see the old component. The BuddyPress messages component can be left active — Better Messages does not require disabling it. If you do disable it, nothing breaks on the Better Messages side.

What happens to existing BuddyPress message threads?​

The data stays in the database. Better Messages reads existing BuddyPress threads on first install and continues them inside the new messenger, so members do not lose history.

Does it work with BuddyBoss?​

Yes — BuddyBoss is a BuddyPress fork. Better Messages has a dedicated BuddyBoss integration that takes over the BuddyBoss messenger the same way the BuddyPress version takes over the BuddyPress messenger. See the BuddyBoss integration docs.

Can members block each other?​

Yes — the User Block feature lets any member block another. Blocked users cannot send new messages or see the blocker online. Admins can also globally block users from the Better Messages → Reports screen.

Is there a mobile app for members?​

Yes — there is a Capacitor-based mobile app for iOS and Android, with push notifications when members receive a new message.

See also​

Install Better Messages from WordPress.org →