Troubleshooting
Stories Not Displaying
Section titled “Stories Not Displaying”Check the shortcode. Make sure you have added one of the WP Stories shortcodes to your page (e.g., [wb-story-activities]). Verify there are no typos in the shortcode name.
Check user login status. If Hide Stories from Logged-Out Users is enabled in General Settings, visitors who are not logged in will not see any stories. Log in to test, or disable this setting temporarily.
Check story expiry. If story expiry is enabled in Displaying Options, stories older than the configured visibility duration will not appear. Verify the duration is set to a reasonable value.
Check publication status. If the Default Publication Status is set to Draft or Pending Review in User Publishing Options, newly submitted stories will not be visible until an admin publishes them.
Image Editor Not Loading
Section titled “Image Editor Not Loading”Clear your browser cache. The TUI Image Editor relies on several JavaScript libraries. A stale cache can prevent them from loading correctly. Do a hard refresh (Ctrl+Shift+R or Cmd+Shift+R).
Check for JavaScript conflicts. Open your browser’s developer console (F12) and look for JavaScript errors. Conflicts with other plugins that load Vue.js or Fabric.js on the same page can cause issues. Try deactivating other plugins one at a time to identify the conflict.
Check HTTPS. The editor loads some libraries from CDNs. If your site uses HTTPS but has mixed content issues, these resources may be blocked.
Upload Failing
Section titled “Upload Failing”Check PHP upload limits. WordPress respects the server’s PHP configuration. Verify these values in your php.ini or hosting panel:
upload_max_filesize– must be at least as large as your Maximum File Size setting.post_max_size– should be larger thanupload_max_filesize.max_execution_time– increase if large uploads are timing out.
Check the Maximum File Size setting. Go to WP Stories > Settings > User Publishing Options and verify the file size limit. Set it to 0 to disable client-side validation and test if the server limits are the issue.
Check file types. WP Stories accepts image and video files. PDFs, documents, and other file types are not allowed.
Stories Not Expiring
Section titled “Stories Not Expiring”Check cron. WP Stories relies on WordPress cron (wp-cron.php) for automatic story deletion. If your host has disabled WP-Cron, scheduled cleanup tasks will not run.
To verify, install a cron monitoring plugin or check if DISABLE_WP_CRON is set to true in wp-config.php. If WP-Cron is disabled, set up a real server cron job to trigger wp-cron.php at regular intervals.
Check Display Options. Confirm that Enable Story Expiry is toggled on and that the Set Visibility Duration field has a value greater than 0.
Integration Not Working
Section titled “Integration Not Working”Verify the plugin is active. BuddyPress, PeepSo, or BuddyBoss Platform must be active for the respective integration tab to appear. Check Plugins to confirm the social plugin is activated.
Enable the integration. Go to WP Stories > Settings > Integrations and make sure the toggle for your platform (BuddyPress or PeepSo) is turned on. Save changes after toggling.
Check component requirements. For BuddyPress, the Activity component must be enabled. Go to Settings > BuddyPress > Components and confirm Activity is checked.
Mobile Layout Issues
Section titled “Mobile Layout Issues”Check theme compatibility. WP Stories includes responsive CSS, but some themes may apply conflicting styles. Inspect the story elements on mobile using browser developer tools to identify any theme CSS overrides.
Test with a default theme. Temporarily switch to a default WordPress theme (like Twenty Twenty-Four) to determine if the issue is theme-specific.
Clear caching. If you use a caching plugin or CDN, clear all caches after updating WP Stories. Stale CSS files can cause layout problems on mobile devices.