5 min read
BuddyPress Shortcodes: Complete Guide and Reference for 2026
BuddyPress shortcodes let you embed community components, activity feeds, member directories, group listings, and more, anywhere on your WordPress site. Instead of being limited to BuddyPress’s default pages, shortcodes give you full control over where community features appear.
Want to show a member directory on your homepage? An activity feed in a sidebar widget? A group listing on a landing page? Shortcodes make all of this possible without custom code.
Here’s the complete reference for BuddyPress shortcodes in 2026, including core shortcodes, the Shortcodes for BuddyPress plugin, and shortcodes from popular BuddyPress add-ons.
BuddyPress Core Pages (Built-in)
BuddyPress itself doesn’t use traditional shortcodes. Instead, it uses dedicated pages assigned through Settings > BuddyPress > Pages. When you install BuddyPress, it creates pages for:
- Activity, The sitewide activity stream
- Members, The member directory
- Groups, The group directory (if Groups component is active)
- Registration, The registration page
- Activation, Account activation page
These pages work automatically, BuddyPress detects them and renders the appropriate content. But what if you want activity feeds on multiple pages? Or a member listing in a blog post? That’s where the Shortcodes for BuddyPress plugin comes in.
Shortcodes for BuddyPress Plugin
Shortcodes for BuddyPress is the essential plugin for embedding BuddyPress components anywhere. It provides three core shortcodes with extensive parameters for customization.
Activity Shortcode
The [activity-listing] shortcode embeds BuddyPress activity streams on any page or post.
Basic usage:
[activity-listing], Shows all sitewide activities[activity-listing per_page=5], Shows 5 activities[activity-listing user_id=1], Shows activities from a specific user[activity-listing object=groups], Shows only group activities
Advanced parameters:
| Parameter | Description | Example |
|---|---|---|
per_page | Number of activities to display | per_page=10 |
user_id | Show activities from specific user | user_id=1 |
object | Filter by component (groups, friends, etc.) | object=groups |
action | Filter by action type | action=activity_update |
primary_id | Show activities for specific group ID | primary_id=5 |
scope | Filter scope (favorites, friends, groups, mentions) | scope=favorites |
role | Show activities from users with specific role | role=administrator |
title | Custom title above the activity list | title="Latest Updates" |
Combination examples:
[activity-listing role="administrator" scope=favorites], Favorite activities from admins[activity-listing object=groups primary_id=12 per_page=3], Last 3 activities from group ID 12[activity-listing title="Community Feed" per_page=10], Named activity feed with 10 items
Members Shortcode
The [members-listing] shortcode displays member directories anywhere on your site.
Basic usage:
[members-listing], Shows all members[members-listing per_page=6], Shows 6 members[members-listing type=active], Shows recently active members
Advanced parameters:
| Parameter | Description | Example |
|---|---|---|
per_page | Number of members to display | per_page=12 |
type | Sort order (active, newest, alphabetical, random, popular) | type=newest |
member_type | Filter by BuddyPress member type | member_type=vendor |
search_terms | Search for specific members | search_terms="john" |
include | Show only specific user IDs | include="1,5,12" |
exclude | Exclude specific user IDs | exclude="3,7" |
title | Custom title above the member list | title="Our Team" |
Use cases:
[members-listing type=active per_page=4], “Who’s Online” widget on your homepage[members-listing member_type=vendor per_page=8], Vendor directory for marketplace communities[members-listing type=newest per_page=6 title="Welcome Our Newest Members"], New member spotlight
Groups Shortcode
The [groups-listing] shortcode embeds group directories on any page.
Basic usage:
[groups-listing], Shows all groups[groups-listing per_page=4], Shows 4 groups[groups-listing type=popular], Shows most popular groups
Advanced parameters:
| Parameter | Description | Example |
|---|---|---|
per_page | Number of groups to display | per_page=6 |
type | Sort order (active, newest, popular, alphabetical, random) | type=popular |
group_type | Filter by BuddyPress group type | group_type=course |
user_id | Groups that a specific user belongs to | user_id=1 |
search_terms | Search for specific groups | search_terms="photography" |
include | Show only specific group IDs | include="2,5,8" |
title | Custom title above the group list | title="Featured Groups" |
Shortcodes for BuddyPress Pro (Elementor Widgets)
The Pro version adds Elementor widgets for all BuddyPress shortcodes. Instead of typing shortcodes manually, you drag and drop BuddyPress components into your Elementor layouts with visual configuration panels.
Elementor widgets included:
- BP Activity Widget, Visual activity feed with all shortcode parameters as GUI controls
- BP Members Widget, Member directory with layout options (grid, list) and sorting controls
- BP Groups Widget, Group directory with visual customization
- Custom styling options, Colors, typography, and spacing controls within Elementor
The Pro version is ideal if you’re building pages with Elementor on themes like Reign or BuddyX Pro, both of which have deep Elementor integration.
Shortcodes from Other BuddyPress Plugins
Several BuddyPress add-on plugins provide their own shortcodes. Here are the most commonly used ones:
bbPress (Forums)
[bbp-forum-index], Displays the complete forum index[bbp-forum-form], Shows the new forum creation form[bbp-single-forum id=X], Displays a specific forum[bbp-topic-form], Shows the new topic creation form[bbp-single-topic id=X], Displays a specific topic[bbp-login], Login form[bbp-register], Registration form[bbp-search], Forum search form
GamiPress (Gamification)
[gamipress_points], Shows current user’s points[gamipress_achievements], Lists achievements/badges[gamipress_ranks], Shows rank progression[gamipress_leaderboard], Displays community leaderboard[gamipress_earnings], Shows user’s earning history
BuddyPress Member Blog
[bp-member-blog], Shows member’s blog posts on their profile[bp-member-blog-form], Blog post creation form for members
Practical Implementation Examples
Here’s how to use BuddyPress shortcodes for common community page layouts:
Homepage Community Section
Add a community preview to your homepage that shows activity, featured members, and popular groups:
[activity-listing per_page=5 title="What's Happening"][members-listing type=active per_page=6 title="Active Members"][groups-listing type=popular per_page=3 title="Popular Groups"]
Landing Page for New Members
Create a welcome page that showcases community highlights:
[members-listing type=newest per_page=8 title="Newest Members"][groups-listing type=active per_page=4 title="Active Groups to Join"][activity-listing per_page=3 title="Recent Community Activity"]
Vendor Directory (Marketplace Communities)
For communities using BuddyVendor with marketplace functionality:
[members-listing member_type=vendor per_page=12 title="Our Vendors"][groups-listing group_type=vendor-group per_page=6 title="Vendor Communities"]
Need Help Building Your BuddyPress Community?
Shortcodes handle layout, but a fully custom BuddyPress site requires architecture decisions that go beyond copy-paste snippets. When your requirements outgrow what plugins provide out of the box, our team steps in. See our BuddyPress development service.
Quick Reference Table
| Shortcode | Plugin | Purpose |
|---|---|---|
[activity-listing] | Shortcodes for BuddyPress | Embed activity feed anywhere |
[members-listing] | Shortcodes for BuddyPress | Embed member directory anywhere |
[groups-listing] | Shortcodes for BuddyPress | Embed group directory anywhere |
[bbp-forum-index] | bbPress | Display forum index |
[bbp-single-forum] | bbPress | Display specific forum |
[gamipress_achievements] | GamiPress | Show badges and achievements |
[gamipress_leaderboard] | GamiPress | Community leaderboard |
[bp-member-blog] | BP Member Blog | Member blog posts |
BuddyPress shortcodes are the bridge between your community features and your page layouts. Whether you’re using the Gutenberg editor, Elementor with Shortcodes for BuddyPress Pro, or simply adding shortcodes to widget areas, they give you full control over how community components appear on your site.
Related reading