Title: Scrollytelling
Author: Scrollytelling
Published: 08 Luj 2026
Last modified: 08 Luj 2026
---
Search plugins
# Scrollytelling
By [Scrollytelling](https://profiles.wordpress.org/scrollytelling/)
[Download](https://downloads.wordpress.org/plugin/scrollytelling.1.0.2.zip)
* [Details](https://lmo.wordpress.org/plugins/scrollytelling/#description)
* [Reviews](https://lmo.wordpress.org/plugins/scrollytelling/#reviews)
* [Installation](https://lmo.wordpress.org/plugins/scrollytelling/#installation)
* [Development](https://lmo.wordpress.org/plugins/scrollytelling/#developers)
[Support](https://wordpress.org/support/plugin/scrollytelling/)
## Description
[Scrollytelling](https://scrollytelling.ai/) 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](https://scrollytelling.ai/);
this plugin only displays already-published, public stories.
#### Getting started (2 minutes)
1. **Publish a story** at [scrollytelling.ai](https://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=` 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/
## Screenshots
[⌊Creating a story in the Scrollytelling editor at scrollytelling.ai.⌉⌊Creating
a story in the Scrollytelling editor at scrollytelling.ai.⌉[
Creating a story in the Scrollytelling editor at scrollytelling.ai.
[⌊A published scroll-driven story — the experience your visitors get.⌉⌊A published
scroll-driven story — the experience your visitors get.⌉[
A published scroll-driven story — the experience your visitors get.
[⌊Scenes animate cinematically as the reader scrolls.⌉⌊Scenes animate cinematically
as the reader scrolls.⌉[
Scenes animate cinematically as the reader scrolls.
[⌊Every story is a scroll-driven web page you can embed with a URL, the block, or
the shortcode.⌉⌊Every story is a scroll-driven web page you can embed with a URL,
the block, or the shortcode.⌉[
Every story is a scroll-driven web page you can embed with a URL, the block, or
the shortcode.
## Blocks
This plugin provides 1 block.
* Scrollytelling Story Embed an interactive, scroll-driven Scrollytelling story—
inline or as a launch card.
## Installation
1. In your WordPress admin, go to **Plugins Add Plugin**, search for “Scrollytelling”,
then install and activate it.
2. Open any post or page in the editor, click the **+** button (top left), search
for **Scrollytelling Story**, and add the block.
3. Paste your published story URL (every published story has an address like `https://
my-story.scrollytelling.ai` — find yours in your scrollytelling.ai dashboard).
In the block settings on the right, choose **Inline** or **Card** display.
4. Even simpler: paste a story URL on an empty line in the editor and press Enter —
WordPress embeds it automatically, just like a YouTube link.
5. _(Optional)_ In **Settings Scrollytelling**, paste an API key (from Scrollytelling
Settings Connect WordPress) to browse and insert your stories from the editor
without copying URLs. The same page has a “How to embed” recap.
## FAQ
### How do I add a story to a post?
Three ways: add the **Scrollytelling Story** block (click **+** in the editor and
search for it), paste a published story URL on an empty line (it auto-embeds), or
use the `[scrollytelling url="…"]` shortcode. A short guide also appears under **
Settings Scrollytelling** after activation.
### Do I need a Scrollytelling account?
To embed by URL, no — any published story URL works. To browse and insert your own
stories from the editor, connect your account with an API key.
### Inline or card?
Inline embeds the scroll experience directly in your page (with a fullscreen button).
The card shows a poster that opens the full immersive story — best when you don’t
want a nested scroll area.
### Does it work with the Classic Editor?
Yes — use the `[scrollytelling]` shortcode.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“Scrollytelling” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Scrollytelling ](https://profiles.wordpress.org/scrollytelling/)
[Translate “Scrollytelling” into your language.](https://translate.wordpress.org/projects/wp-plugins/scrollytelling)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/scrollytelling/), check
out the [SVN repository](https://plugins.svn.wordpress.org/scrollytelling/), or
subscribe to the [development log](https://plugins.trac.wordpress.org/log/scrollytelling/)
by [RSS](https://plugins.trac.wordpress.org/log/scrollytelling/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.0.2
* New: getting-started guidance — a one-time welcome notice after activation, a“
How to embed a story” guide on the settings page, and Settings / How-to-embed
links on the Plugins screen.
* Inline embed height from the shortcode/block is now capped at 4000px, matching
the settings limit.
* The settings height field now allows the full 200–4000px range.
* Uninstall also removes cached URL-verification transients.
#### 1.0.1
* Settings page now loads its JavaScript with wp_enqueue_script() + wp_localize_script()
instead of an inline script tag (WordPress.org review compliance).
* Inline iframes now render only for verified story URLs: *.scrollytelling.ai stories
are allowed directly, custom-domain stories are confirmed against the Scrollytelling
API (with caching); unverified URLs fall back to the link card.
* Hardened the card poster style against CSS injection via the thumbnail attribute.
* The account-status endpoint now requires administrator capability.
* Requires WordPress 6.6+ (the block uses the JSX runtime introduced in 6.6).
#### 1.0.0
* Initial release: block, shortcode, oEmbed auto-embed, inline + card display modes,
optional account connection.
## Meta
* Version **1.0.2**
* Last updated **14 hours ago**
* Active installations **Fewer than 10**
* WordPress version ** 6.6 or higher **
* Tested up to **7.0**
* PHP version ** 7.4 or higher **
* Language
* [English (US)](https://wordpress.org/plugins/scrollytelling/)
* Tags
* [embed](https://lmo.wordpress.org/plugins/tags/embed/)[interactive](https://lmo.wordpress.org/plugins/tags/interactive/)
[scroll](https://lmo.wordpress.org/plugins/tags/scroll/)[scrollytelling](https://lmo.wordpress.org/plugins/tags/scrollytelling/)
[storytelling](https://lmo.wordpress.org/plugins/tags/storytelling/)
* [Advanced View](https://lmo.wordpress.org/plugins/scrollytelling/advanced/)
## Ratings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/scrollytelling/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/scrollytelling/reviews/)
## Contributors
* [ Scrollytelling ](https://profiles.wordpress.org/scrollytelling/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/scrollytelling/)