Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/hlibpanchenko/wp-stories-block/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
WP Stories Block
WP Stories Block is a WordPress plugin that adds an ACF-powered Gutenberg block for displaying stories in an Instagram-style format.
It renders a horizontal stories feed on the frontend and opens stories in a fullscreen modal with autoplay, swipe navigation, and pause-on-hold behavior.
Features
- ACF Gutenberg block for stories
- Horizontal stories timeline
- Fullscreen modal viewer
- Autoplay with progress bars
- Swipe left / right navigation
- Pause on hold (press and hold to pause story)
- Image and video support
- Video duration-based playback (max 15 seconds)
- Profile link, avatar, and title inside the modal
- Mobile-friendly (touch & pointer events)
- BEM-based class naming with wpstb prefix
Requirements
- WordPress 6.0+
- Advanced Custom Fields (ACF) PRO or Free (with block support)
- PHP 7.0+
Requires ACF (free or pro).
How to use
1. Add the block
1. Open a page in the Gutenberg editor.
2. Add the WP Stories Block from the Widgets category.
2. Configure block fields
The block provides several configuration options:
- Stories Title
Optional heading displayed above the stories feed.
- Switch Stories Mode
- Manually – universal mode. Stor