Skip to main content
This quickstart guide will walk you through creating and publishing your first web story using Web Stories for WordPress.
This tutorial assumes you’ve already installed and activated the Web Stories for WordPress plugin. If you haven’t done so yet, please complete the installation first.

Step 1: Access the Story Editor

Navigate to the Web Stories dashboard in your WordPress admin:
1

Open WordPress Admin

Log in to your WordPress admin dashboard at your-site.com/wp-admin
2

Navigate to Stories

In the left sidebar, click Stories → Add New or go to Stories → Dashboard and click Create New Story
3

Choose Your Starting Point

You’ll be presented with two options:
Browse the available pre-built templates and click Use template on one you like. This is the fastest way to get started.

Step 2: Understand the Editor Interface

The Web Stories editor has four main areas:

Canvas

The center workspace where you design your story pages

Library Panel

Left sidebar with media, text, shapes, and stickers

Design Panel

Right sidebar for styling selected elements

Top Toolbar

Document settings, preview, and publish controls

Step 3: Customize Your Story

Add and Edit Text

  1. Click Text in the Library panel
  2. Drag a text element onto the canvas
  3. Double-click to edit the text
  4. Use the Design panel to:
    • Change font, size, and color
    • Adjust alignment and letter spacing
    • Apply text effects

Add Images or Videos

  1. Click Media in the Library panel
  2. Choose from:
    • Upload - Upload from your computer
    • Media Library - Use existing WordPress media
    • Third-party - Browse free stock images/videos
  3. Drag media onto the canvas
  4. Resize and position as needed

Manage Pages

  • Add a page: Click the + button at the bottom of the canvas
  • Delete a page: Click the page thumbnail and select delete
  • Reorder pages: Drag page thumbnails in the page carousel
  • Duplicate a page: Right-click a page thumbnail and select duplicate

Add Animations

  1. Select an element on the canvas
  2. In the Design panel, click Animation
  3. Choose an effect (Fade In, Fly In, Zoom, etc.)
  4. Adjust duration and easing
  5. Preview by clicking the play button

Step 4: Configure Story Settings

Click Document in the top toolbar to access story settings:
  • Title: Required, shown in story lists and search results
  • Excerpt: Brief description for SEO and social sharing
Upload a poster image (required):
  • Recommended size: 640×853 pixels or 3:4 ratio
  • This appears in story carousels and previews
  • Author: Set the story author
  • Categories/Tags: Organize your stories
  • Featured Image: For WordPress integration

Step 5: Preview Your Story

Before publishing, preview your story:
  1. Click Preview in the top toolbar
  2. Check on different devices using the device selector
  3. Test animations and interactions
  4. Verify all text is readable
  5. Ensure images display correctly
Use the preview to check:
  • Page transitions
  • Animation timing
  • Color contrast
  • Mobile responsiveness

Step 6: Publish Your Story

When you’re ready to publish:
1

Final Review

Double-check your title, excerpt, and poster image are set
2

Publish

Click Publish in the top toolbar. Your story is now live!
3

View Published Story

Click View Story to see it on your site

Step 7: Share and Embed

After publishing, you have several options to share your story:

Embed in a Post or Page

  1. Edit any WordPress post or page
  2. Add the Web Stories Embed block
  3. Select your story
  4. Customize display options
  5. Publish
Your story has a unique URL like:
https://your-site.com/web-stories/your-story-title/
Share this link on social media, in emails, or anywhere you want.

Add to Archive

Stories automatically appear in your archive at /web-stories/ (if enabled in settings).

Best Practices

  • Aim for 5-20 pages per story
  • Each page should convey one clear message
  • Avoid overcrowding pages with too many elements
  • Design for vertical (9:16) viewing
  • Use large, readable text (minimum 16px)
  • Ensure tap targets are at least 48×48 pixels
  • Test on actual mobile devices
  • Images: Minimum 720×1280 pixels
  • Videos: 720p or higher recommended
  • Compress files for faster loading
  • Always include alt text for accessibility
  • Don’t animate everything - it can be overwhelming
  • Use entrance animations to guide attention
  • Keep animations under 1 second
  • Test that animations enhance, not distract

Troubleshooting

Make sure you’ve set:
  • A story title
  • A poster image
  • At least one page with content
  • Upload higher resolution images (minimum 720×1280)
  • Avoid scaling images beyond their native size
  • Use the correct aspect ratio
  • Preview in a modern browser (Chrome, Firefox, Safari)
  • Check that animations are enabled in story settings
  • Verify the AMP plugin is activated if using AMP mode

Next Steps

Congratulations on creating your first web story! Here’s what to explore next:

Master the Editor

Learn advanced editor features and techniques

Add Analytics

Track how readers engage with your stories

Monetize Stories

Learn how to add ads and earn revenue

SEO Optimization

Optimize stories for search engines

Getting Help

If you need assistance:

Build docs developers (and LLMs) love