Scrollytelling

Scrollytelling turns an idea into a single, scroll-driven web page — animated, cinematic, and fully editable. This plugin lets you drop your published stories into WordPress.

• Block — add the “Scrollytelling Story” block, paste a story URL, and choose how it appears.
• Shortcode — [scrollytelling url="https://my-story.scrollytelling.ai"].
• Auto-embed (oEmbed) — paste a story URL on its own line and it embeds automatically.
• Two display modes — inline (the story embeds in the page, with a fullscreen button) or a card (a poster that opens the full immersive story).
• Connect your account (optional) — add an API key to browse your own stories and insert them with a click, no copy-pasting URLs.

You create and publish stories at scrollytelling.ai; this plugin only displays already-published, public stories.

Getting started (2 minutes)

1. Publish a story at scrollytelling.ai — every published story gets its own address, like https://my-story.scrollytelling.ai. You can copy it from your dashboard.
2. Open any post or page in the WordPress editor.
3. Click the + button (top left of the editor), search for “Scrollytelling Story”, and add the block.
4. Paste your story URL into the block — the story appears right in the editor.
5. In the block settings (right sidebar), choose Inline (the story plays inside your page) or Card (a poster that opens the full story), and adjust the height.

Shortcuts: pasting a story URL on an empty line embeds it automatically, just like a YouTube link — or type /scrollytelling in the editor. In the Classic editor, use the shortcode below.

Optional: connect your account under Settings → Scrollytelling with an API key (created at Scrollytelling → Settings → Connect WordPress) to insert stories from a picker instead of pasting URLs. The same settings page has a “How to embed” recap whenever you need it.

External services

This plugin connects to the Scrollytelling API (https://api.scrollytelling.ai):

• oEmbed — when a story is embedded, WordPress requests https://api.scrollytelling.ai/published/oembed?url=<your story URL> to get the embed markup. Only the story URL is sent.
• Account connection (optional) — if you save an API key, the plugin requests https://api.scrollytelling.ai/wp/stories and /wp/ping server-side, sending your API key, to list your own published stories in the editor.

Embedded stories load from your story’s public address (e.g. https://your-story.scrollytelling.ai).

Terms: https://scrollytelling.ai/terms-of-service/ — Privacy: https://scrollytelling.ai/privacy-policy/