Mini Widgets

Better Messages provides mini chat widgets fixed to the bottom of the screen — giving users quick access to conversations, friends, groups, courses, AI bots, and chat rooms from anywhere on the site. Two display styles available: Classic Bar (tab bar at the bottom) or Floating Bubble (Intercom-style circular button).

The mini widget floating on a regular WordPress page — the Conversations panel is open in the bottom-right corner, showing the six-tab navigation and a list of recent threads with avatars

How it works#

Mini widgets are small panels anchored to the bottom of the browser window that remain visible as users browse your website. They provide quick access to conversations, friends lists, and group lists without navigating to the main messaging page. Each widget type can be independently enabled and restricted by user role.

Available widgets#

Better Messages 2.15+ ships seven widget types, each with its own settings panel:

Conversations — compact list of recent conversations with unread counts
Friends — list of friends with online status (requires BuddyPress, Ultimate Member, or PeepSo)
Groups — list of social groups with quick access to group conversations (requires BuddyPress, Ultimate Member, PeepSo, or FluentCommunity Spaces)
Courses — list of courses the user is enrolled in or instructs (requires Tutor LMS, LearnPress, or LearnDash). LearnDash Group cohorts also appear here, alongside the actual courses
Users — browse and message any site member; optional online-only filtering, online-first ordering, sort by last activity or registration date, and three display modes (all users, by role, or a hand-picked list)
AI Bots — start or continue conversations with configured AI chat bots; supports "all enabled bots" or a curated subset
Chat Rooms — browse public chat rooms with an optional online-count badge

Key capabilities#

Three placement surfaces per widget — Mini Bar (bottom of screen), Side Panel, and Mobile Bar — each independently toggleable and role-restrictable
Two display styles for the Mini Bar: Classic Bar (tab bar at the bottom) or Floating Bubble (circular button that expands into a panel)
Custom Bubble Icon — choose from preset icons or paste your own SVG
Per-widget icon picker — customize the icon shown on the Mini, Side Panel, and Mobile bars
Per-widget Search Box toggle — show or hide the inline search field above each list
"Hide Tab When Empty" — hide the Friends / Groups / Courses / AI Bots / Chat Rooms / Users tab entirely when the current user has nothing to show, instead of rendering an empty list
Smooth open/close animations (toggleable)
Close button for each widget
Role-based visibility restrictions per placement
Customizable widget display order (drag-and-drop)
First tab opens by default — drag any tab first, on any of the three surfaces, and the messenger opens on it, so a rooms-first or people-first community does not start on the conversations list
Points balance display when a points system (MyCred/GamiPress) is configured
Works alongside other page content

note

Mini Chats (popup chat windows), Combined Mini Chat widget, and Bubble Chat Heads require the WebSocket version.

Display Styles#

Better Messages supports two ways of displaying mini widgets:

Classic Bar#

A tab bar fixed to the bottom of the browser window. Clicking a tab expands the corresponding panel above it. This is the traditional layout used in messaging widgets.

Floating Bubble#

A circular floating button anchored to the corner of the screen, similar to chat widgets used by services like Intercom and Messenger. Clicking the bubble expands it into a chat panel. The bubble icon can be customized from a curated set of preset icons or by pasting custom SVG markup.

How to enable#

Navigate to WP Admin → Better Messages → Settings → Mini Widgets.

The Mini Widgets settings page is split into per-widget sub-tabs:

Layout — top-level layout options: Mini Bar display style (Classic Bar or Floating Bubble), Bubble Icon picker, animations, Side Panel and Mobile Bar enable toggles, drag-and-drop ordering of widgets within each placement — the first tab of each surface is the one the messenger opens on, unless Remember Last Tab is enabled — and the Mini Chats / Combined Chats / Bubble Chat Heads switches
Conversations / Friends / Groups / Courses / AI Bots / Chat Rooms / Users — one sub-tab per widget. Each exposes the widget's icon, the "Hide Tab When Empty" and "Show Search Box" toggles, role restrictions for the Mini / Side Panel / Mobile placements, and any widget-specific settings (e.g. display mode, online filtering, hand-picked lists)

Choosing which tab the messenger opens on#

The messenger opens on whichever tab is first in the order — the same rule on all three surfaces. By default that is the conversations list; if your community lives somewhere else — chat rooms, the member directory — drag that tab to the first position instead.

Conversations is draggable like every other tab of the Side Panel and the Mobile Tab Bar (it just cannot be switched off there), and each surface keeps its own order. Whenever the first tab is not available to a particular visitor — a guest, or a widget that was later switched off — the next available tab opens instead.

The collapsed (compact) side panel keeps the tab switcher too: tabs stack vertically as icons in the narrow column, with names shown as tooltips.

Remember Last Tab#

Remember Last Tab at Settings → Mini Widgets → Layout → Side Panel changes the rule for members who have already been using the messenger: instead of the first tab, it reopens on whichever tab that member used last. New visitors, and anyone who has not opened a tab yet, still start on the first tab in your order.

The choice is stored in the member's own browser, so it survives a reload and is shared between the tabs they have open. It applies to the Side Panel and the Mobile Tab Bar; the mini widgets bar has always worked this way. If the remembered tab is no longer on offer — the widget was switched off, or the member is now a guest who cannot see it — the first available tab opens instead.

info

Available since Better Messages 2.15.28.

Links to a conversation#

A link that points at a particular conversation always opens the tab that conversation belongs to, whatever your order says and whatever the member last used. A link to a chat room opens the chat rooms list, and a link to a private or group conversation opens the conversations list.

A link that starts a conversation counts too. A "Send message" button in a forum profile or member directory carries no conversation yet — it opens the screen for writing one — and the conversations list opens beside it just the same.

This is what makes those buttons behave, so a member following one sees their conversations next to the message rather than an unrelated list.

info

Available since Better Messages 2.15.28.

Customization#

The bubble button and chat heads can be customized via WP Admin → Appearance → Customize → Better Messages → Mini Widgets & Mini Chats:

Bubble Button Size — diameter of the floating bubble button (40–80px)
Bubble Button Roundness — border radius of the bubble (0% for square, 50% for circle)
Chat Head Size — diameter of recently closed chat avatar bubbles (30–70px)
Chat Head Roundness — border radius of chat heads
Mini widgets position — left or right side of the screen

Frequently asked questions#

Yes — the per-widget role restrictions handle most cases (e.g. hide for guests). To hide every widget on specific pages (checkout, immersive course videos, etc.), add custom CSS scoped to those pages that targets the mini-widget container.

Does the bubble icon support animated GIFs or only static images?#

The Bubble Icon picker accepts SVG markup. For animated icons, use animated SVG (works in all modern browsers). GIFs aren't supported in the icon slot.

Are mini widgets visible to guest users?#

Yes — guests see the widget if guest chat is enabled. Use the role-based visibility settings to restrict if needed (e.g., hide for guests to encourage sign-up).

How does the Floating Bubble interact with other sticky elements?#

Position the bubble (left/right) and tune the bottom margin to avoid overlap with cookie banners, live-chat plugins, or sticky footers. Test on mobile and desktop separately.

The widget itself works on both versions, but AI Chat Bots is a WebSocket-version feature — clicking through to a bot conversation requires the upgraded version.