WP Stories
Your BuddyPress community feed is a scrollable list with no ephemeral, visual-first format to drive quick engagement. WP Stories adds Instagram-style tappable stories to BuddyPress, BuddyBoss, and PeepSo communities, supporting image and
Instagram-style stories for WordPress. Members post photos and videos that appear in a tappable tray and disappear after a set time - or stay forever, if that is what you want.
Works standalone, and integrates with BuddyPress, BuddyBoss Platform and PeepSo.
Requires: WordPress 6.5+, PHP 8.0+. Tested to WordPress 7.0.
Start here
Section titled “Start here”I have just installed the plugin. → Installation → Quick setup
Between them these get you from a fresh activation to a working story tray on a page, in about ten minutes.
I want stories on my community site. → BuddyPress · BuddyBoss · PeepSo
Turn on the integration and the story tray appears above the activity feed, with a Create Story button for members.
I want stories somewhere specific. → Shortcode reference
Five shortcodes cover the tray, a single collection, one member’s stories, and the submission form.
Decide how stories behave
Section titled “Decide how stories behave”| I want to… | Go to |
|---|---|
| Change how long stories stay visible | Display options - Story Expiry |
| Delete old stories automatically to save space | Display options - Stories & Attachment Deletion |
| Choose who may post stories | User publishing - Authorized User Roles |
| Control who members can share with | User publishing - Available Visibility Options |
| Review stories before they appear | User publishing - Default Publication Status |
| Limit file types or sizes | User publishing - Allowed File Types |
| Change the tray style or colours | General settings |
| Find other Wbcom plugins | Discover tab |
If something is wrong
Section titled “If something is wrong”Covers the usual ones: the tray not appearing, uploads failing, stories vanishing sooner than expected, and the story viewer not opening.
Two behaviours that look like bugs but are not:
- A story disappeared before its expiry. Check Story Expiry and whether the member set it to a restricted visibility - a friends-only story is invisible to non-friends regardless of expiry.
- “Only Me” stories are visible to administrators. That is what the setting has always done; as of 2.4.2 the label says so.
Upgrading to 2.4.2
Section titled “Upgrading to 2.4.2”Two things to know before you update a live site.
Automatic deletion now works. It never actually ran in earlier versions because of a bug. If you had Schedule Automatic Deletion switched on, your stories were never deleted - so simply fixing it would have removed everything older than your retention period on the first run. Instead, deletion is paused after updating and you get an admin notice telling you exactly how many stories are affected. Nothing is deleted until you review the setting and save it. Full detail: Display options.
Friends-only stories become visible to more people. The friendship lookup previously only ran inside the activity stream, so friends-only behaved like private everywhere else. It now works on every surface. This is the setting doing what it always claimed, but it is a visible change.
For developers
Section titled “For developers”→ Hooks and filters - all 35 hooks, with signatures and file references → Image editor
The plugin has no custom REST controllers. Front-end behaviour runs through eight
AJAX actions; the three that read or write a story resolve access through a
single filterable check, wp_stories_user_can_view_story_item.