better_messages
The primary shortcode for embedding the Better Messages inbox on any WordPress page. For logged-in users it shows the full messenger (conversation list + active conversation). For non-logged-in users it shows a login form, prompting them to sign in to access their messages.
When to use it
| Page type | Why embed [better_messages] |
|---|---|
| Dedicated "Messages" page | The primary use — a top-level Messages link in your site nav |
| Member dashboard | Show inbox alongside other account features |
| Custom-built profile pages | Embed inbox inline with profile actions |
| Theme-builder pages (Elementor / Bricks) | Drop the shortcode into a flexible page layout |
Usage
[better_messages]
No attributes — this shortcode is intentionally simple. To configure messenger behavior, use the global settings at WP Admin → Better Messages → Settings.
Default behavior
| User state | What renders |
|---|---|
| Logged in | Full messenger UI — conversation list + selected thread |
| Not logged in (guest disabled) | WordPress login form prompting sign-in |
| Not logged in (guest enabled) | Guest entry prompt or auto-join, per global guest settings |
Frequently asked questions
Where do I put this shortcode?
Most sites use the plugin's Settings → General → Messages Location option to point the messenger to a specific page. If you'd rather embed manually, create a page, drop in [better_messages], and add a menu link.
Can I have multiple "messages" pages?
Yes — the shortcode can appear on multiple pages. Each renders the same inbox. Useful if you have role-specific dashboards (e.g., one for buyers, one for sellers).
How does this differ from the other shortcodes?
| Shortcode | Purpose |
|---|---|
[better_messages] | Full inbox layout (this shortcode) |
[better_messages_single_conversation] | Embed one specific thread |
[better_messages_user_conversation] | Auto-create/open a conversation with a specific user |
[better_messages_my_messages_url] | Just the URL (for menu items) |
[better_messages_live_chat_button] | A button that starts a chat |
Does this work with page builders?
Yes — Elementor, Beaver Builder, Bricks, Divi, and similar all support the standard WordPress shortcode. Drop a "Shortcode" widget on the page and enter [better_messages].
Will the messenger respect my theme's styling?
Yes — the messenger inherits your theme's typography and respects the configured accent color. For deeper styling, use the Easy Customization settings or add custom CSS.
See also
- better_messages_my_messages_url — URL-only variant for menus
- better_messages_single_conversation — embed one specific thread
- better_messages_user_conversation — auto-create a thread with a user
- better_messages_live_chat_button — chat-starting button
- Easy customization — color and layout options