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)
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, 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)

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.