Skip to content

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.

  1. Edit a page in the block editor.
  2. Open the block inserter (the + button).
  3. Open the Member Blog category, or search for a block by name, such as “Recent Member Posts”.
  4. 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.

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; 0 uses 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.

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.

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.

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.