Blocks
BuddyPress Member Blog overviewFree + ProGet BuddyPress Member Blog →
Every WB Member Blog shortcode is also a block. A block is its shortcode: it runs the same code and has the same attributes with the same defaults, so a block and a shortcode on two pages always show the same thing. Pick whichever fits how you build pages.
Finding the blocks
Section titled “Finding the blocks”- Edit a page in the block editor.
- Open the block inserter (the + button).
- Open the Member Blog category, or search for a block by name, such as “Recent Member Posts”.
- Insert the block and set its options in the block settings sidebar.
The editor shows a live preview for every block except Post Submission Form, which shows a labelled placeholder. The form itself renders normally on the published page.
Blocks in widget areas and templates
Section titled “Blocks in widget areas and templates”The blocks work anywhere a block can go: page content, a block widget area or sidebar (Appearance > Widgets), and block theme templates. Each block brings its own styling, so it looks the same in a sidebar as on a page.
Block options match the shortcode attributes. Two blocks have options worth knowing before you place them:
- Member Blog Authors has Pagination and View All Url.
- Follow Writer has Author (a user ID;
0uses the writer of the post being shown) and Show Count. Every Follow Writer button for the same writer changes together when a reader presses one.
Two things to know when you place a list block in a narrow sidebar:
-
Set Columns to 1 so each card gets the full width. Member Blog Authors set to 1 column lists writers as compact rows, avatar beside name.
-
Member Blog Authors shows page links under the list when there are more writers than its Count. For a short sidebar list, turn Pagination off: it shows up to Count writers with no page links. Add your full writers page in View All Url to show a View all writers link under the list, so every writer can still be reached.
-
Grids and author cards adapt to the width of the column they sit in, not the width of the screen, so a block in a narrow sidebar lays out compactly on a wide desktop.
When a block has nothing to show
Section titled “When a block has nothing to show”A block that is empty because of how the site is set up, such as a switch that is off or a writer ID that does not exist, shows administrators a short note that starts Only admins see this: and says what to change. Members and visitors see nothing where the block sits, so it is safe to leave on a public page. Shortcode examples inside a note appear as text and are not run.
A shortcode typed into a classic Text widget is not seen by the styling check. Use the block instead, or turn the card styles on with the bpmb_enqueue_card_styles filter.
Free blocks
Section titled “Free blocks”All blocks use the wbcom-member-blog/ prefix.
| Block | Block name | Same as shortcode |
|---|---|---|
| Recent Member Posts | wbcom-member-blog/recent-posts |
[bp-member-blog-recent] |
| Popular Member Posts | wbcom-member-blog/popular-posts |
[bp-member-blog-popular] |
| Member Blog List | wbcom-member-blog/member-blog-list |
[bp-member-blog-list] |
| Member Blog Categories | wbcom-member-blog/categories |
[bp-member-blog-categories] |
| Member Blog Authors | wbcom-member-blog/authors |
[bp-member-blog-authors] |
| Featured Posts | wbcom-member-blog/featured |
[bp-member-blog-featured] |
| Related Posts | wbcom-member-blog/related-posts |
[bp-member-blog-related] |
| Topic Hub | wbcom-member-blog/topic |
[bp-member-blog-topic] |
| Reading List | wbcom-member-blog/reading-list |
[bp-member-blog-reading-list] |
| Following Feed | wbcom-member-blog/following-feed |
[bp-member-blog-following] |
| Follow Writer | wbcom-member-blog/follow-writer |
[bp-member-blog-follow] |
| Post Submission Form | wbcom-member-blog/post-form |
[bp-member-blog] |
| Member Blog Dashboard | wbcom-member-blog/dashboard |
[member-blog-dashboard] |
Attributes, defaults and empty states are in the Shortcodes Reference.
One naming difference: the categories shortcode’s style attribute (cloud, list or grid) is stored on the block as sc_style, because style is reserved by the block editor for colours and spacing. The shortcode is unchanged; write style="list" in a shortcode as before.
Pro blocks (Pro)
Section titled “Pro blocks (Pro)”WB Member Blog Pro adds a block for each of its shortcodes. Each Pro block appears in the inserter only while its module is switched on.
| Block | Block name | Same as shortcode | Module |
|---|---|---|---|
| Co-Authors | wbcom-member-blog/coauthors |
[bp-member-blog-coauthors] |
Co-Authors |
| Co-Authored Posts | wbcom-member-blog/coauthored-posts |
[bp-member-blog-coauthored-posts] |
Co-Authors |
| Co-Author Invitations | wbcom-member-blog/invitations |
[bp-member-blog-invitations] |
Co-Authors |
| Series Navigation | wbcom-member-blog/series-nav |
[bp-member-blog-series-nav] |
Post Series |
| Series Table of Contents | wbcom-member-blog/series-toc |
[bp-member-blog-series-toc] |
Post Series |
| Series List | wbcom-member-blog/series-list |
[bp-member-blog-series-list] |
Post Series |
| Scheduled Posts | wbcom-member-blog/scheduled-posts |
[bp-member-blog-scheduled] |
Post Scheduling |
| Publishing Calendar | wbcom-member-blog/calendar |
[bp-member-blog-calendar] |
Post Scheduling |
| Blog Analytics | wbcom-member-blog/analytics |
[bp-member-blog-analytics] |
Post Analytics |
| Custom Field | wbcom-member-blog/custom-field |
[bp-member-blog-custom-field] |
Custom Fields |
| My Credit History | wbcom-member-blog/credit-history |
[bpmb_my_credit_history] |
Post Credits |
| Credit Packs | wbcom-member-blog/credit-packs |
[bpmb_credit_packs] |
Post Credits, with WooCommerce active |
| Author Settings | wbcom-member-blog/author-settings |
[bp-member-blog-author-settings] |
Author Dashboard |
Six of these blocks are pieces of the member dashboard and no longer appear in the block inserter: Blog Analytics, Publishing Calendar, Scheduled Posts, Co-Author Invitations, My Credit History and Author Settings. Pages that already contain them keep working. For new pages, use the member dashboard, or the shortcode in the table above.
See the Pro Shortcodes Reference for their attributes.

