Shortcodes Reference

Get Started

Display member blog content anywhere on your site using these shortcodes. Add them to pages, posts, widgets, or theme templates.

Post Submission Form

[bp-member-blog-form]

Displays the post creation form where members write and submit new blog posts.

Use Case

Place this on a dedicated “Create Post” or “Submit Article” page.

Requirements

  • User must be logged in
  • User’s role must be in allowed roles list
  • User’s member type must be allowed (if configured)

What Members See

  • Post title field
  • Content editor (based on your Editor settings)
  • Featured image uploader
  • Category selector
  • Submit/Draft buttons

Member Blog List

[bp-member-blog-list]
Displays blog posts from a specific member.

Attributes

Attribute Default Description
user_id Current user User ID to show posts from
count 5 Number of posts to display
columns 1 Grid columns (1-3)
show_excerpt yes Display post excerpts
show_image yes Display featured images
show_date yes Display publish date
show_author no Display author info
orderby date Sort by: date, title, modified
order DESC Sort order: ASC or DESC
category (empty) Filter by category slug
class (empty) Custom CSS class

Examples

Basic usage — show current user’s posts:

[bp-member-blog-list]

Show 10 posts from user ID 5 in 2 columns:

[bp-member-blog-list user_id="5" count="10" columns="2"]

Show posts from a category without images:

[bp-member-blog-list category="tutorials" show_image="no" count="8"]

Use Cases

  • Member profile sidebar widget
  • Author archive pages
  • “My Posts” dashboard section

Recent Posts

[bp-member-blog-recent]

Displays recent blog posts from all members across your site.

Attributes

Attribute Default Description
count 10 Number of posts to display
columns 3 Grid columns (1-4)
show_excerpt yes Display post excerpts
show_image yes Display featured images
show_date yes Display publish date
show_author yes Display author name
show_avatar yes Display author avatar
category (empty) Filter by category slug
exclude_users (empty) Comma-separated user IDs to exclude
class (empty) Custom CSS class

Examples

Basic usage — show 10 recent posts:

[bp-member-blog-recent]

Homepage feature — 6 posts in 3 columns:

[bp-member-blog-recent count="6" columns="3" show_excerpt="yes"]

Category-specific feed:

[bp-member-blog-recent category="news" count="5" columns="1"]

Exclude admin posts:

[bp-member-blog-recent exclude_users="1" count="12"]

Use Cases

  • Homepage “Latest from Community” section
  • Category landing pages
  • Sidebar “Recent Posts” widget

Popular Posts

[bp-member-blog-popular]

Displays most viewed posts from your members.

Attributes

Attribute Default Description
count 10 Number of posts to display
columns 3 Grid columns (1-4)
show_excerpt yes Display post excerpts
show_image yes Display featured images
show_date yes Display publish date
show_author yes Display author name
show_views yes Display view count
timeframe all Filter: all, week, month, year
category (empty) Filter by category slug
class (empty) Custom CSS class

Examples

All-time popular posts:

[bp-member-blog-popular count="5"]

This month’s popular posts:

[bp-member-blog-popular timeframe="month" count="10"]

Popular posts in a category:

[bp-member-blog-popular category="tutorials" show_views="yes"]

Use Cases

  • “Trending” section on homepage
  • Sidebar “Popular This Week” widget
  • Category page highlights

Category Display

[bp-member-blog-categories]

Displays blog categories in various formats.

Attributes

Attribute Default Description
style cloud Display style: cloud, list, or grid
count 20 Number of categories to show
show_count yes Display post counts
orderby count Sort by: name, count, or id
order DESC Sort order: ASC or DESC
hide_empty yes Hide categories with no posts
exclude (empty) Category IDs to exclude
parent (empty) Only show children of this parent category
class (empty) Custom CSS class

Examples

Tag cloud style:

[bp-member-blog-categories style="cloud"]

Vertical list with post counts:

[bp-member-blog-categories style="list" show_count="yes" orderby="name"]

Grid of top 12 categories:

[bp-member-blog-categories style="grid" count="12"]

Use Cases

  • Blog archive sidebar
  • Category navigation page
  • Footer category links

Top Authors

[bp-member-blog-authors]

Showcases your most active member contributors.

Attributes

Attribute Default Description
count 10 Number of authors to display
columns 4 Grid columns (1-4)
show_avatar yes Display author avatar
show_count yes Display post count
show_bio no Display author bio excerpt
avatar_size 80 Avatar size in pixels
orderby post_count Sort: post_count, name, recent
order DESC Sort order: ASC or DESC
role (empty) Filter by user role
class (empty) Custom CSS class

Examples

Top 8 contributors in a grid:

[bp-member-blog-authors count="8" columns="4"]

Authors with bios:

[bp-member-blog-authors show_bio="yes" columns="2" count="6"]

Most recently active authors:

[bp-member-blog-authors orderby="recent" count="5"]

Use Cases

  • “Meet Our Contributors” page
  • Homepage author spotlight
  • Community recognition section

Shortcode Tips

Combining Shortcodes

Create a complete blog page by combining shortcodes:

<h2>Popular This Month</h2>
[bp-member-blog-popular timeframe="month" count="3" columns="3"]

<h2>Latest Posts</h2>
[bp-member-blog-recent count="9" columns="3"]

<h2>Browse by Category</h2>
[bp-member-blog-categories style="grid" count="12"]

<h2>Top Contributors</h2>
[bp-member-blog-authors count="8" columns="4"]

Using in Widgets

Most shortcodes work in text widgets. For sidebars:

  1. Go to Appearance → Widgets
  2. Add a Text or Custom HTML widget
  3. Paste your shortcode
  4. Save the widget

Using in Theme Templates

In PHP template files:

<?php echo do_shortcode('[bp-member-blog-recent count="5"]'); ?>

Styling Shortcode Output

All shortcodes output elements with CSS classes you can target:

/* Container */
.bp-member-blog-list { }

/* Individual post card */
.bp-member-blog-item { }

/* Post title */
.bp-member-blog-title { }

/* Post excerpt */
.bp-member-blog-excerpt { }

/* Author info */
.bp-member-blog-author { }
Last updated: January 8, 2026