A Story opened from a row sends
openedStory as it
opens. Since 10.13.13, the event could arrive only when the player closed,
or not at all. The first openedPage after a row tap reports storyListTap
again.
Version 11.0.0 changes where the SDK keeps viewing history, how the script
build loads its code, and how the npm package declares its files and
dependencies. Read Migrate from version 10 to 11
before you update.
Viewing history now comes from Storyteller. With the default privacy
options, initialize loads the user's read Pages, Clip likes and views, and
Poll and Quiz answers, and waits for them. History for an externalId
follows the user across browsers and devices. Read state that 10.13
recorded carries over with the default privacy options. See
Remote viewing store.
initialize rejects with InvalidApiKeyError, NetworkError, or
NetworkTimeoutError when the viewing-history request fails. No
sdkInitialized event is sent in that case. See
Handle initialization errors.
The SDK calls a new viewing-history endpoint, and Clips requests use a new
path and send a new request header. If a proxy or allowlist sits in front of
the Storyteller API, allow them. See the
migration guide.
Renamed the local storage keys for viewing history. Storyteller.likes,
Storyteller.viewedClips, Storyteller.pollAnswers,
Storyteller.triviaQuizAnswers, and Storyteller.readPages replace
Storyteller.clipLikes, Storyteller.clipsViewed,
Storyteller.pollAnswerMap, Storyteller.quizAnswerMap, and
Storyteller.storiesReadMap. The SDK does not read or remove the earlier
keys. With enableRemoteViewingStore: false, history saved by 10.13 does
not carry over. See
local storage items.
The script build loads Story player, Clips player, Poll, Quiz, and caption
code as separate files from the directory that served storyteller.min.js.
If you host the SDK files yourself, deploy every file in the version's dist
directory and keep the file names. Your Content Security Policy must allow
scripts from that directory. See
Host the SDK files.
The npm package declares @types/react (>=17 <20) and
@types/react-router-dom (^5.1.7) as peer dependencies, because its
TypeScript declarations import them. npm 7 and later installs them. See
TypeScript declarations.
The npm package adds import and require entry points and publishes its
declarations at dist/index.npm.d.ts. It no longer ships index.js,
types/*.d.ts, or SDK source files. Import only the package root and
dist/storyteller.min.css.
The SDK no longer installs the reflect-metadata polyfill on the page's
global Reflect object. If your code uses Reflect.getMetadata, import
reflect-metadata in your application.
ActivityType has a new sdkInitialized
member. Update exhaustive switch statements over ActivityType.
Story has new pinnedChipText and customLiveChipText properties for
custom chip text. Update typed
test data.
Removed the undocumented QuizRenderer.clearQuizData() method.
Added destroy() to every view. Call it
before your application removes or replaces the view's container.
Added the sdkInitialized activity event.
onUserActivityOccurred receives it when
enableUserActivityTracking is on. initializationSucceeded is true when
Settings load and false when the Settings request fails. Other startup
failures reject initialize without this event.
When the Stories API uses started-aware ordering,
rows and grids show Stories the user has not opened, then Stories in
progress, then finished Stories. Pinned and Live Stories keep their
priority.
Clips rows, grids, and players that show a Collection
load more Clips as the user reaches
the last loaded Clip, including inside a Category. onDataLoadComplete
reports only the first page.
The liveChip theme for round and rectangular tiles adds
unreadBackgroundGradient, readBorderColor, and unreadBorderColor. See
Story tile chips.
The Clips player shows a Clip's long description
when it has one. Users can expand the title, description, and Categories,
and scroll them when they are long.
The remote Clips player theme can turn on
compact Clip action buttons. If your
remote theme already sets clipsActionButtonCompactSize, the buttons change
when you update.
The remote Clips player theme can hide like and share counts with
showLikeCount and showShareCount. If your remote
theme already sets them, the counts change when you update.
Every Story, Poll, Quiz, and Story ad activity event now includes
categoryDetails. Clip events already included it, and Clip ad events have
no Category fields. See the Story,
Poll, Quiz, and
Ad events.
The script-tag (CDN) build downloads less code up front. The main script is
about 77 KB gzip, down from about 197 KB in 10.13.17. The script that runs
inside each Story is about 34 KB, down from about 191 KB.
The script build downloads Story player, Clips player, Poll, Quiz, and
caption code the first time a page needs it. A Stories view also starts a
low-priority download of the AMP player script before the first Story opens.
See version 11 behavior.
The npm package still includes all SDK code in one JavaScript file. Your
bundler decides what your users download and when.
initialize calls with the same API key and externalId, made while an
earlier call is still running, share its startup work.
Story and Clips views avoid repeated layout and lookup work.
The SDK is compiled to ES2020. Supported browsers are unchanged from 10.13.
Updated the default AMP runtime, which renders Stories, to 20260925.1. The
Story ad, Story swipe, and next Story button fixes below come from this
update.
Each wrapped line of a Clip or Story caption
has its own background. Captions align to the start of the line, including
on right-to-left pages.
Clip captions appear after the Clip starts playing.
The Story CC control appears only on video Pages, and it moves above a
call-to-action that overlaps it.
A caption theme field set for a feed now overrides only that field of the
tenant caption theme. Before, a feed caption
theme replaced the tenant theme as a whole.
Caption defaults changed to 16 px text, the font's natural line height, and
a #171A25 background. In 10.13 they were 18 px text, a 22 px line height,
and a #000000 background.
A Story opened from a row sends
openedStory as it
opens. Since 10.13.13, the event could arrive only when the player closed,
or not at all. The first openedPage after a row tap reports storyListTap
again.
Added configuration.context to the onUserActivityOccurred callback data.
The selected view supplies the context when views share a player and when an
SDK action opens related content. Context changes apply while a view remains
mounted. The value stays outside Storyteller activity API requests.
Added getStoriesCount and getClipsCount methods to the shared SDK
instance. Integrations can check for content before they create an optional
list view.
Row images now receive their source when they approach the horizontal
viewport. Story players keep every AMP Story entry and create a poster image
only for the active Story.
Fixed Stories skipping their first page right after a swipe to the next Story. The background Story refresh introduced in 10.13.13 hot-swapped playerStories, which restarted the player and re-showed the active Story on its read-state initial page (the page after the one on screen). The same re-run also switched the swiped-to Story to single-Story playback mode, reset its view start time, and registered a duplicate read-state listener on every refresh. Story switches now leave the running player alone and a refreshed Story only re-shows when its active page no longer exists.
Updated the default AMP runtime to 20260910.1, which keeps Story video-ad audio controls available when the ad capability signal and media setup complete in either order.
Added closed captions for Clips and Stories when the matching captions feature flag is enabled. The SDK supports WebVTT cues, a saved caption preference, caption theme settings, toggle analytics, and safe caption controls for Story media pages.
Contained rejected activity-tracking requests inside the SDK so blocked or failed best-effort activity delivery does not reach host applications as an unhandled Promise rejection. Story navigation and existing activity callbacks continue unchanged.
Updated the default AMP runtime to 20260817.1, fixing captions-state synchronization and quiz result-page enablement during AMP page initialization while preserving useful errors for invalid page references.
Added instructions.iconHighlightColor and instructions.iconColor theme properties for independently styling the highlight and foreground colours of built-in Story instruction icons. iconHighlightColor falls back to colors.primary, while iconColor falls back to the effective instructions.headingColor. Existing custom instructions.icons URL overrides remain unchanged, so colour-only branding does not require custom icon assets.
Fixed Story Page API host resolution so URL- and storage-provided customInstanceHost values cannot control iframe requests. Story Pages now use trusted server metadata when present and otherwise retain the existing environment-based API defaults.
Added RTL support across Stories rows, Clips rows, and the Story player, including right-to-left rail controls, edge fades, story text direction, and player controls. See RTL support.
Added true single-clip playback support for StorytellerClipsPlayerView, allowing embedded Clips players to initialize from either clipId or externalId while preserving the existing collection-based constructor.
Fixed Clips video ad playback state so user-paused ads stay paused after CTA taps, mute changes, browser tab lifecycle changes, and ad completion events.
Fixed iOS Safari GAM clip video ads so they start muted when needed for autoplay, resume cleanly after clip navigation, and keep poster surfaces visible instead of showing a black frame.
Fixed GAM SafeFrame video ads so poster fallbacks remain visible until a video frame is painted, looped video ads initialize correctly, and paused ads are not resumed by mute changes.
Reapplied the Web SDK GAM category targeting fix so SDK-provided category KVPs are passed as arrays, preventing double-encoded comma separators in AMP DoubleClick requests.
Fixed production AMP URL resolution for the hotfix path and updated the default AMP runtime to 20260518.1.
Fixed Web SDK GAM category targeting values so SDK-provided category KVPs are passed as arrays, preventing double-encoded comma separators in AMP DoubleClick requests.
Updated the default AMP runtime to 20260428.1 to include story audio and story ad playback fixes.
Fixed Story player start/close handling so visible players can reassert playback and unmute state during story navigation without resetting the active player.
The logic for updating the hash on Clip navigation now relies on the location pathname instead of the default history API behaviour (which uses base HTML elements if provided)
Deprecated theme.storyTiles.title.show property in favour of a value that can be set in the CMS. Starting from this version, this Theme property has no effect. Default value for the CMS property is true.
Ad KVPs now match the mobile SDKs (collection was renamed to stCollection, clipCategories was renamed to stClipCategories, and so on)
Introduced an initial index for the betweenStoriesAndPages and betweenClips ads strategies, that will be the index after which the first ad will appear. Can be configured in the CMS.
Implemented VPPA compliance measures including SHA256 hashing for User IDs for requests and removal of Content ID from ad requests. See Privacy and Tracking for details.
Deprecated Storyteller.currentUserId method as part of privacy enhancements.
The instructions screen is now only shown when opening a Story from the row (not when a Story is opened directly from its URL)
The gradient behind the Story/Clip titles on rectangular tiles is now shown by default (it can be hidden by setting storyTiles.rectangularTile.showGradient to false)
Improved console error logs when no Clips or Stories available
Improved mouse scrolling experience for Clips on Firefox
Bug Fixes:
Fixed a bug where it was possible for the first Story in a view to skip pre-loading for tenants with a lot of Stories
Fixed a bug where it was possible for the ads action button destination to be displayed instead of the advertiser name if no advertiser name was provided
If the lists.row.scrollIndicatorInlineAlignment theme property is set to outside and the row doesn't have enough items for the scroll indicators to be visible, the empty space where the indicator would normally sit has been removed
The Story rows scroll indicator can now be horizontally aligned with the thumbnails (instead of the whole cell which includes the title) using the storyTiles.circularTile.scrollIndicatorBlockAlignment theme property
Added the ability to swipe down to dismiss a Story
Added the ability for share links to open a specific Page (instead of just the first Page in the Story)
Added a playAllStories option to the theme which will not exit the Story player when the user reaches the end of their unread Stories - but rather keep them in the Stories experience until they see every Story in the row
Bug Fixes:
Fixed an issue which could cause Polls not to display in certain scenarios
{"slug": "changelog", "page_title": "Release Notes", "page_url": "Changelog/", "canonical_url": "/web/Changelog/", "markdown": "# Changelog\n\nLinks in these release notes go to the current guides, which describe the\nlatest version.\n\n## **11.0.1** - 2026.09.30\n\n### Bug Fixes\n\n- A Story opened from a row sends\n [`openedStory`](analytics/StoryEvents.md#opened-story-openedstory) as it\n opens. Since 10.13.13, the event could arrive only when the player closed,\n or not at all. The first `openedPage` after a row tap reports `storyListTap`\n again.\n\n## **11.0.0** - 2026.09.25\n\nVersion 11.0.0 changes where the SDK keeps viewing history, how the script\nbuild loads its code, and how the npm package declares its files and\ndependencies. Read [Migrate from version 10 to 11](getting-started/migrate-to-11.md)\nbefore you update.\n\n### Breaking Changes\n\n- Viewing history now comes from Storyteller. With the default privacy\n options, `initialize` loads the user's read Pages, Clip likes and views, and\n Poll and Quiz answers, and waits for them. History for an `externalId`\n follows the user across browsers and devices. Read state that 10.13\n recorded carries over with the default privacy options. See\n [Remote viewing store](PrivacyAndTracking.md#remote-viewing-store).\n- `initialize` rejects with `InvalidApiKeyError`, `NetworkError`, or\n `NetworkTimeoutError` when the viewing-history request fails. No\n `sdkInitialized` event is sent in that case. See\n [Handle initialization errors](Quickstart.md#handle-initialization-errors).\n- The SDK calls a new viewing-history endpoint, and Clips requests use a new\n path and send a new request header. If a proxy or allowlist sits in front of\n the Storyteller API, allow them. See the\n [migration guide](getting-started/migrate-to-11.md#viewing-history-loads-from-storyteller).\n- Renamed the local storage keys for viewing history. `Storyteller.likes`,\n `Storyteller.viewedClips`, `Storyteller.pollAnswers`,\n `Storyteller.triviaQuizAnswers`, and `Storyteller.readPages` replace\n `Storyteller.clipLikes`, `Storyteller.clipsViewed`,\n `Storyteller.pollAnswerMap`, `Storyteller.quizAnswerMap`, and\n `Storyteller.storiesReadMap`. The SDK does not read or remove the earlier\n keys. With `enableRemoteViewingStore: false`, history saved by 10.13 does\n not carry over. See\n [local storage items](PrivacyAndTracking.md#functional-cookies-and-local-storage-items).\n- The script build loads Story player, Clips player, Poll, Quiz, and caption\n code as separate files from the directory that served `storyteller.min.js`.\n If you host the SDK files yourself, deploy every file in the version's `dist`\n directory and keep the file names. Your Content Security Policy must allow\n scripts from that directory. See\n [Host the SDK files](getting-started/script.md#host-the-sdk-files).\n- The npm package declares `@types/react` (`>=17 <20`) and\n `@types/react-router-dom` (`^5.1.7`) as peer dependencies, because its\n TypeScript declarations import them. npm 7 and later installs them. See\n [TypeScript declarations](getting-started/npm.md#typescript-declarations).\n- The npm package adds `import` and `require` entry points and publishes its\n declarations at `dist/index.npm.d.ts`. It no longer ships `index.js`,\n `types/*.d.ts`, or SDK source files. Import only the package root and\n `dist/storyteller.min.css`.\n- The SDK no longer installs the `reflect-metadata` polyfill on the page's\n global `Reflect` object. If your code uses `Reflect.getMetadata`, import\n `reflect-metadata` in your application.\n- `ActivityType` has a new [`sdkInitialized`](Analytics.md#sdk-initialization)\n member. Update exhaustive `switch` statements over `ActivityType`.\n- `Story` has new `pinnedChipText` and `customLiveChipText` properties for\n [custom chip text](Themes.md#live-chip-gradient-and-borders). Update typed\n test data.\n- Removed the undocumented `QuizRenderer.clearQuizData()` method.\n\n### New Features\n\n- Added [`destroy()`](StorytellerListView.md#destroy) to every view. Call it\n before your application removes or replaces the view's container.\n- Added the [`sdkInitialized` activity event](Analytics.md#sdk-initialization).\n [`onUserActivityOccurred`](StorytellerDelegate.md#methods) receives it when\n `enableUserActivityTracking` is on. `initializationSucceeded` is `true` when\n Settings load and `false` when the Settings request fails. Other startup\n failures reject `initialize` without this event.\n- When the Stories API uses [started-aware ordering](StorytellerListView.md#story-ordering),\n rows and grids show Stories the user has not opened, then Stories in\n progress, then finished Stories. Pinned and Live Stories keep their\n priority.\n- Clips rows, grids, and players that show a Collection\n [load more Clips](StorytellerListView.md#clips-paging) as the user reaches\n the last loaded Clip, including inside a Category. `onDataLoadComplete`\n reports only the first page.\n- Story tiles show [custom Live and pinned chip text](Themes.md#live-chip-gradient-and-borders)\n from Story content.\n- The `liveChip` theme for round and rectangular tiles adds\n `unreadBackgroundGradient`, `readBorderColor`, and `unreadBorderColor`. See\n [Story tile chips](Themes.md#live-chip-gradient-and-borders).\n- The Clips player shows a Clip's [long description](StorytellerListView.md#clip-details)\n when it has one. Users can expand the title, description, and Categories,\n and scroll them when they are long.\n- The remote Clips player theme can turn on\n [compact Clip action buttons](Themes.md#compact-clip-action-buttons). If your\n remote theme already sets `clipsActionButtonCompactSize`, the buttons change\n when you update.\n- The remote Clips player theme can hide like and share counts with\n [`showLikeCount` and `showShareCount`](Themes.md#clip-player). If your remote\n theme already sets them, the counts change when you update.\n- Every Story, Poll, Quiz, and Story ad activity event now includes\n `categoryDetails`. Clip events already included it, and Clip ad events have\n no Category fields. See the [Story](analytics/StoryEvents.md),\n [Poll](analytics/PollEvents.md), [Quiz](analytics/QuizEvents.md), and\n [Ad](analytics/AdEvents.md) events.\n\n### Performance\n\n- The script-tag (CDN) build downloads less code up front. The main script is\n about 77 KB gzip, down from about 197 KB in 10.13.17. The script that runs\n inside each Story is about 34 KB, down from about 191 KB.\n- The script build downloads Story player, Clips player, Poll, Quiz, and\n caption code the first time a page needs it. A Stories view also starts a\n low-priority download of the AMP player script before the first Story opens.\n See [version 11 behavior](getting-started/migrate-to-11.md#review-version-11-behavior).\n- The npm package still includes all SDK code in one JavaScript file. Your\n bundler decides what your users download and when.\n- `initialize` calls with the same API key and `externalId`, made while an\n earlier call is still running, share its startup work.\n- Story and Clips views avoid repeated layout and lookup work.\n- The SDK is compiled to ES2020. Supported browsers are unchanged from 10.13.\n\n### Improvements\n\n- Updated the default AMP runtime, which renders Stories, to `20260925.1`. The\n Story ad, Story swipe, and next Story button fixes below come from this\n update.\n- Poll and Quiz [answers can show two lines](views/engagement.md#answer-text).\n Longer answers are clipped.\n- Each wrapped line of a Clip or Story [caption](Themes.md#closed-captions)\n has its own background. Captions align to the start of the line, including\n on [right-to-left pages](StorytellerListView.md#rtl-support).\n- Clip captions appear after the Clip starts playing.\n- The Story CC control appears only on video Pages, and it moves above a\n call-to-action that overlaps it.\n- A caption theme field set for a feed now overrides only that field of the\n tenant [caption theme](Themes.md#closed-captions). Before, a feed caption\n theme replaced the tenant theme as a whole.\n- Caption defaults changed to 16 px text, the font's natural line height, and\n a `#171A25` background. In 10.13 they were 18 px text, a 22 px line height,\n and a `#000000` background.\n- Stories that have no Pages are no longer shown.\n\n### Bug Fixes\n\n- If a user pauses a Story and then answers its Poll or Quiz, the Story\n resumes and the pause button updates.\n- When [`playAllStories`](Themes.md#player) is off, the Story player moves\n from read pinned or Live Stories to the next unread Story instead of\n closing.\n- When the player refreshes an open Story, the Story keeps its pinned or Live\n position.\n- On desktop, the next Story button is no longer disabled on the last pinned\n or Live Story when the player continues to another Story.\n- Forward navigation stays available when a user returns to a Story they\n finished earlier in the same player session.\n- Browser Back and Forward move between the Pages of an open Story.\n- Going back to an earlier Story shows the Story ad from that point again.\n- Going back through a Page Ad returns to the Page before the ad.\n- An ad after the last Page of the last pinned Story no longer loops. The\n next tap or swipe moves on or closes the player.\n- Swiping between Stories no longer gets stuck where read Stories meet unread\n Stories.\n- Clips ad frequency and the first ad position reset when a user closes and\n reopens the Clips player.\n- Clips ads keep appearing after a user changes swipe direction.\n- Users can swipe, drag, or scroll from a Clips image ad to the next or\n previous Clip.\n- On desktop, a loaded Clips ad in the preview no longer turns into a Clip,\n and an ad that has not loaded is skipped before the preview shows it.\n- In Safari, the Clips player background no longer flashes black between\n Clips.\n- In Safari, a paused Clip shows its image instead of a black frame.\n- On macOS, switching to another window no longer briefly plays the Clip.\n- In a short looping Clips feed, the Clip on screen plays. Keyboard and screen\n reader users reach only that Clip's controls.\n- Escape closes only the visible Story player. In Safari, closing Stories\n repeatedly no longer raises a `history.replaceState` error.\n- Activity requests sent while the SDK saves the user ID now include\n `externalId`.\n- A Quiz completion is recorded when the score is zero.\n- Repeated taps record a Poll or Quiz answer once.\n- [`StorytellerEmbeddedClipsPlayerView`](StorytellerEmbeddedClipsPlayerView.md)\n no longer locks page scrolling when it first renders.\n\n### Documentation\n\n- Reorganized the docs by task. New guides show how to install the SDK\n [with a script tag](getting-started/script.md) or\n [from npm](getting-started/npm.md),\n [use React or Next.js](getting-started/react-nextjs.md),\n [choose a view](views/index.md),\n [show Polls and Quizzes](views/engagement.md),\n [troubleshoot an integration](getting-started/troubleshooting.md), and\n [migrate from version 10 to 11](getting-started/migrate-to-11.md).\n- Added an [API reference](reference/index.md) for every public method,\n property, type, and callback, and a guide to\n [open a player programmatically](OpenPlayer.md).\n- Added a guide to [use these docs with AI assistants](AI.md).\n\n## **10.13.18** - 2026.09.30\n\n### Bug Fixes\n\n- A Story opened from a row sends\n [`openedStory`](analytics/StoryEvents.md#opened-story-openedstory) as it\n opens. Since 10.13.13, the event could arrive only when the player closed,\n or not at all. The first `openedPage` after a row tap reports `storyListTap`\n again.\n\n## **10.13.17** - 2026.09.23\n\n### New Features\n\n- Added [`configuration.context`](Analytics.md#context) to the [`onUserActivityOccurred`](StorytellerDelegate.md#methods) callback data.\n The selected view supplies the context when views share a player and when an\n SDK action opens related content. Context changes apply while a view remains\n mounted. The value stays outside Storyteller activity API requests.\n\n## **10.13.16** - 2026.09.15\n\n### New Features\n\n- Added [`getStoriesCount`](AdditionalMethods.md#getstoriescount) and [`getClipsCount`](AdditionalMethods.md#getclipscount) methods to the shared SDK\n instance. Integrations can check for content before they create an optional\n list view.\n\n### Improvements\n\n- Row images now receive their source when they approach the horizontal\n viewport. Story players keep every AMP Story entry and create a poster image\n only for the active Story.\n\n## **10.13.15** - 2026.09.10\n\n### Bug Fixes\n\n- Fixed Stories skipping their first page right after a swipe to the next Story. The background Story refresh introduced in 10.13.13 hot-swapped `playerStories`, which restarted the player and re-showed the active Story on its read-state initial page (the page after the one on screen). The same re-run also switched the swiped-to Story to single-Story playback mode, reset its view start time, and registered a duplicate read-state listener on every refresh. Story switches now leave the running player alone and a refreshed Story only re-shows when its active page no longer exists.\n\n## **10.13.14** - 2026.09.10\n\n### Bug Fixes\n\n- Updated the default AMP runtime to `20260910.1`, which keeps Story video-ad audio controls available when the ad capability signal and media setup complete in either order.\n\n## **10.13.13** - 2026.08.24\n\n### New Features\n\n- Added [closed captions for Clips and Stories](Themes.md#closed-captions) when the matching captions feature flag is enabled. The SDK supports WebVTT cues, a saved caption preference, caption theme settings, toggle analytics, and safe caption controls for Story media pages.\n\n### Bug Fixes\n\n- Included the internal declaration files required by the published TypeScript definitions.\n\n## **10.13.12** - 2026.08.19\n\n### Bug Fixes\n\n- Contained rejected activity-tracking requests inside the SDK so blocked or failed best-effort activity delivery does not reach host applications as an unhandled Promise rejection. Story navigation and existing activity callbacks continue unchanged.\n\n## **10.13.11** - 2026.08.17\n\n### Bug Fixes\n\n- Updated the default AMP runtime to `20260817.1`, fixing captions-state synchronization and quiz result-page enablement during AMP page initialization while preserving useful errors for invalid page references.\n\n## **10.13.10** - 2026.08.07\n\n### New Features\n\n- Added [`instructions.iconHighlightColor`](Themes.md#instructions) and [`instructions.iconColor`](Themes.md#instructions) theme properties for independently styling the highlight and foreground colours of built-in Story instruction icons. `iconHighlightColor` falls back to `colors.primary`, while `iconColor` falls back to the effective `instructions.headingColor`. Existing custom `instructions.icons` URL overrides remain unchanged, so colour-only branding does not require custom icon assets.\n\n## **10.13.9** - 2026.07.29\n\n### Bug Fixes\n\n- Fixed Story Page API host resolution so URL- and storage-provided `customInstanceHost` values cannot control iframe requests. Story Pages now use trusted server metadata when present and otherwise retain the existing environment-based API defaults.\n\n## **10.13.8** - 2026.07.09\n\n### New Features\n\n- Added [`clipPlayer.showFeedTitle`](Themes.md#clip-player), [`clipPlayer.showClipTitle`](Themes.md#clip-player), and [`clipPlayer.showNavigationCategories`](Themes.md#clip-player) theme properties so Clips player integrations can hide feed-title, clip-title, and navigation-category chrome independently.\n\n## **10.13.7** - 2026.06.26\n\n### New Features\n\n- Added [`StorytellerEmbeddedClipsPlayerView`](StorytellerEmbeddedClipsPlayerView.md) as a first-class iframe-free embedded Clips player API with the same collection, `clipId`, and `externalId` source contract as [`StorytellerClipsPlayerView`](StorytellerListView.md#clips-player-initialization). See the embedded Clips player docs for [initialization](StorytellerEmbeddedClipsPlayerView.md#initialization), [sizing](StorytellerEmbeddedClipsPlayerView.md#sizing), [configuration](StorytellerEmbeddedClipsPlayerView.md#configuration), and [list configuration](StorytellerListView.md#embedded-clips-player-configuration).\n- Added RTL support across Stories rows, Clips rows, and the Story player, including right-to-left rail controls, edge fades, story text direction, and player controls. See [RTL support](StorytellerListView.md#rtl-support).\n\n### Improvements\n\n- Updated the default AMP runtime to `20260626.1`.\n\n## **10.13.6** - 2026.06.02\n\n### New Features\n\n- Added true single-clip playback support for [`StorytellerClipsPlayerView`](StorytellerListView.md#clips-player-initialization), allowing embedded Clips players to initialize from either `clipId` or `externalId` while preserving the existing collection-based constructor.\n- Added [`topLevelBackButtonEnabled`](StorytellerListView.md#toplevelbackbuttonenabled-clips-player-only) and [`onTopLevelBackTapped`](StorytellerListViewDelegate.md#delegate-methods) support for embedded [`StorytellerClipsPlayerView`](StorytellerListView.md#clips-player-initialization) instances so host apps can render and handle a top-level back button.\n- Added [`theme.player.icons.back`](Themes.md#clip-player) support for customizing the Clips player back/close icon.\n- Added [`publisherProvidedId`](Ads.md#storyteller-ad-manager-integration) support to Google Ad Manager ad configuration so integrations can send PPID separately from custom targeting KVPs.\n\n### Bug Fixes\n\n- Fixed `recordActivity` payloads so activity `externalId` is still included when personalization tracking is disabled.\n\n## **10.13.5** - 2026.05.18\n\n### Bug Fixes\n\n- Fixed Clips video ad playback state so user-paused ads stay paused after CTA taps, mute changes, browser tab lifecycle changes, and ad completion events.\n- Fixed iOS Safari GAM clip video ads so they start muted when needed for autoplay, resume cleanly after clip navigation, and keep poster surfaces visible instead of showing a black frame.\n- Fixed GAM SafeFrame video ads so poster fallbacks remain visible until a video frame is painted, looped video ads initialize correctly, and paused ads are not resumed by mute changes.\n- Reapplied the Web SDK GAM category targeting fix so SDK-provided category KVPs are passed as arrays, preventing double-encoded comma separators in AMP DoubleClick requests.\n- Fixed production AMP URL resolution for the hotfix path and updated the default AMP runtime to `20260518.1`.\n\n## **10.13.4** - 2026.04.30\n\n### Bug Fixes\n\n- Fixed the npm package artifact so package-root imports expose the expected SDK exports and the packaged CSS file is included.\n\n## **10.13.3** - 2026.04.29\n\n### Bug Fixes\n\n- Fixed Web SDK GAM category targeting values so SDK-provided category KVPs are passed as arrays, preventing double-encoded comma separators in AMP DoubleClick requests.\n- Updated the default AMP runtime to `20260428.1` to include story audio and story ad playback fixes.\n- Fixed Story player start/close handling so visible players can reassert playback and unmute state during story navigation without resetting the active player.\n\n## **10.13.2** - 2025.12.1702\n\n### Improvements\n\n- CSS formatting improvements\n\n## **10.13.1** - 2025.12.1701\n\n### Improvements\n\n- The logic for updating the hash on Clip navigation now relies on the location pathname instead of the default history API behaviour (which uses `base` HTML elements if provided)\n\n## **10.13.0** - 2025.11.2601\n\n### New Features\n\n- Add [`stNextClipCategories`](Ads.md#clips-default-targeting) KVP to integrating app custom targeting\n- Added [`row.startPadding`](Themes.md#lists) and [`row.endPadding`](Themes.md#lists) theme properties to add padding to a row that should be flush with the container on scroll\n- Support for the \"Between Pages\" ad strategy\n- Ad events now include an [\"Ad Strategy\" field](analytics/AdEvents.md)\n- Added support for additional action types (linking to Stories, categories, Clips, and Collections)\n- AAds between Stories now display even when a Story is skipped\n\n### Deprecations\n\n- Deprecated `theme.storyTiles.title.show` property in favour of a value that can be set in the CMS. Starting from this version, this Theme property has no effect. Default value for the CMS property is `true`.\n- Ad KVPs now match the mobile SDKs (`collection` was renamed to [`stCollection`](Ads.md#clips-default-targeting), `clipCategories` was renamed to [`stClipCategories`](Ads.md#clips-default-targeting), and so on)\n\n### Improvements\n\n- Added a retry button when a Clip or Story fails to load, replacing the infinite spinner\n- If a row doesn't have a set height, it now defaults to a minimum height\n- Improved focus outlines on row and grid items\n- Removed pause button over image Clip ads\n- Non-AMP ads in Clips no longer show pause/play controls since they cannot be paused\n- Previous and Next Story buttons remain enabled when read/unread status is disabled for a row\n\n### Bug Fixes\n\n- Fixed a bug where ad placement didn\u2019t consistently account for buffer logic\n- Initial ad index now properly accounts for the previous Story\u2019s pages\n\n## **10.12.10** - 2025.11.2601\n\n### Bug Fixes\n\n- Fixed a bug with inconsistent loading of Stories after deleting pages or updating their targeting\n\n## **10.12.9** - 2025.11.1101\n\n### Bug Fixes\n\n- Fixed a bug with inconsistent loading of live Stories when some theme properties are not set\n\n## **10.12.8** - 2025-10.30\n\n### Bug Fixes\n\n- Fixed a bug where it was possible for the wrong CTA to show under Stories ads after navigating back and forth\n\n## **10.12.7** - 2025-10-24\n\n### Improvements\n\n- Added a [`showScrollIndicator`](Themes.md#lists) theme property to hide/show scroll arrows in Stories/Clips rows\n\n## **10.12.6** - 2025-10-23\n\n### Bug Fixes\n\n- Fixed a bug where it was possible for the current category analytics property to be empty in Stories rows with multiple categories\n\n## **10.12.5** - 2025-10-08\n\n### Bug Fixes\n\n- Fixed a bug where it was possible for the \"actionButtonTapped\" event not to get triggered for actions that open in a new tab\n\n## **10.12.5 (alpha.3)** - 2025-09-24\n\n### Improvements\n\n- Fixing generation of `.d.ts` files\n\n## **10.12.5 (alpha.2)** - 2025-09-23\n\n### Improvements\n\n- Fixed a bug where tile size could grow for round tiles when `storyTiles.title.show` was set to `false`\n\n## **10.12.5 (alpha.1)** - 2025-09-19\n\n### Improvements\n\n- Further improvements to support for some CMPs\n\n## **10.12.5 (alpha.0)** - 2025-09-12\n\n### Improvements\n\n- Improving support for some CMPs\n\n## **10.12.4** - 2025-08-25\n\n### Bug Fixes\n\n- Fixed an issue with the Clips player size on some Android devices\n\n## **10.12.3** - 2025-08-22\n\n### Bug Fixes\n\n- Improved the auto-advance behaviour of non-AMP ads in Firefox and Safari\n\n## **10.12.2** - 2025-08-14\n\n### New Features\n\n- Introduced an initial index for the `betweenStoriesAndPages` and `betweenClips` ads strategies, that will be the index after which the first ad will appear. Can be configured in the CMS.\n\n## **10.12.1** - 2025-07-22\n\n### Improvements\n\n- Added `clipShares` as a supported `disabledFunctionalFeatures` value in tracking preferences. For details, see the [Privacy and Tracking](PrivacyAndTracking.md) documentation\n\n## **10.12.0** - 2025-07-17\n\n### Improvements\n\n- Introduced `disabledFunctionalFeatures` option in tracking preferences. For details, see the [Privacy and Tracking](PrivacyAndTracking.md) documentation\n- Setting the [user ID to `null`](Users.md#changing-users) is now supported\n- Introduced `enableRemoteViewingStore` option in tracking preferences. For details, see the [Privacy and Tracking](PrivacyAndTracking.md) documentation\n- The `recentStoryPlaybackMode` is now only saved to local storage if needed for analytics\n- Stopped storing user attributes when the [`enablePersonalization`](PrivacyAndTracking.md#user-personalization) tracking preference is set to `false`\n- Removed unused `settingsSavedDate` local storage item\n\n## **10.11.1** - 2025-06-20\n\nImprovements:\n\n- Removed quiz share button from OneBox stories\n\n## **10.11.0** - 2025-06-19\n\nBreaking changes:\n\n- Implemented VPPA compliance measures including SHA256 hashing for User IDs for requests and removal of Content ID from ad requests. See [Privacy and Tracking](PrivacyAndTracking.md) for details.\n- Deprecated `Storyteller.currentUserId` method as part of privacy enhancements.\n- Added `enableFullVideoAnalytics` property to [`eventTrackingOptions`](PrivacyAndTracking.md) for granular video analytics control. See [Privacy and Tracking](PrivacyAndTracking.md) for details.\n\nImprovements:\n\n- Improved VPPA compliance by removing direct user identifiers from various API requests. See [Privacy and Tracking](PrivacyAndTracking.md) for details.\n- Added support for `sheet` actions in Clips.\n\n## **10.9.1** - 2025-06-02\n\nImprovements:\n\n- Moved some `dependencies` to `devDependencies`\n\n## **10.9.0** - 2025-04-02\n\nFeatures:\n\n- Added the [`enableAdTracking`](PrivacyAndTracking.md#ad-tracking) property to [`eventTrackingOptions`](PrivacyAndTracking.md)\n\nImprovements:\n\n- Non-AMP ads are now supported in Clips as long as they are based on a Storyteller template\n- Better tracking pixels support in Clip ads\n\n## **10.8.0** - 2025-03-07\n\nImprovements:\n\n- The instructions screen is now only shown when opening a Story from the row (not when a Story is opened directly from its URL)\n- The gradient behind the Story/Clip titles on rectangular tiles is now shown by default (it can be hidden by setting [`storyTiles.rectangularTile.showGradient`](Themes.md#story-tiles) to `false`)\n- Better support for non-AMP ads\n\n## **10.7.2** - 2025-01-23\n\nImprovements:\n\n- The instructions screen is now only shown once instead of once per Stories row/grid\n\n## **10.7.1** - 2025-01-17\n\nBug Fixes:\n\n- Fixed a Safari iOS bug where it was possible for the borders of round thumbnails to disappear\n- Fixed a bug where it was possible for some necessary events not to get reported to Storyteller\n- Fixed a bug where it was possible for a Story row to not be clickable after opening a Story from its share link\n\n## **10.7.0** - 2025-01-06\n\nNew Features:\n\n- Added [`#stories/[STORY_ID]`](StorytellerListView.md#basename), [`#clips/[COLLECTION_ID]`](StorytellerListView.md#basename), and [`#clips/[COLLECTION_ID]/[CLIP_ID]`](StorytellerListView.md#basename) routes\n- Added support for reloading Stories and Clips views when exiting the player\n- The [`eventTrackingOptions`](PrivacyAndTracking.md) property can be used for customising the analytics and tracking behavior\n\nImprovements:\n\n- The behaviour and signature of the `open*` methods now match the native SDKs:\n\n <!-- prettier-ignore -->\n * [`openStory`](AdditionalMethods.md#openstory) is now async\n * [`openStoryByExternalId`](AdditionalMethods.md#openstorybyexternalid) is now supported\n * [`openPage`](AdditionalMethods.md#openpage) is now async\n * [`openCategory`](AdditionalMethods.md#opencategory) is now async\n * `openClip` is now deprecated (please use [`openCollection`](AdditionalMethods.md#opencollection) instead)\n * [`openCollection`](AdditionalMethods.md#opencollection) is now async and accepts a destination argument with either a Clip ID or Category ID\n * [`openClipByExternalId`](AdditionalMethods.md#openclipbyexternalid) is now supported\n\nBug Fixes:\n\n- Fixed a bug with linking to a Story not present on the page when `player.playAllStories` theme property was set to `false`\n- Fixed a bug where it was possible for the default basename of a view could be empty if no `data-base-url` was set\n- Fixed a bug where it was possible for the Collection ID param of shared Clips to be empty\n\n## **10.6.0** - 2024-12-17\n\nNew Features:\n\n- Added [`userNavigatedToApp`](StorytellerDelegate.md#methods) method to the Storyteller delegate\n\nImprovements:\n\n- Added default custom targeting values to integrating app ad requests\n\n## **10.5.3** - 2024-12-09\n\nImprovements:\n\n- Added accessible labels to button elements\n\n## **10.5.2** - 2024-11-27\n\nImprovements:\n\n- Removed calls to deprecated Storyteller internal endpoint\n\n## **10.5.1** - 2024-11-15\n\nBug Fixes:\n\n- Fixed a bug where it was possible for some Stories not to autoplay on iOS\n\n## **10.5.0** - 2024-11-14\n\nNew Features:\n\n- Added support for [ads in the Clips Player](Ads.md#clips-adrequestinfo)\n- Added support for \"Share media\" actions\n- Added support for `enableViewedOrdering` in a Clips collection\n\nImprovements:\n\n- Improved focus behaviour for the Story player navigation buttons\n- Grid thumbnails now use the highest quality asset based on their size\n- Added support for Storyteller ads with no actions\n- Mobile CTAs are now aligned to the center by default\n- Improved Story transitions and loading styles\n- Improved full screen styles on mobile\n- Added documentation for Clip events\n- Improved error handling when initialising Storyteller rows in container with invalid IDs\n\nBug Fixes:\n\n- Fixed a bug where it was possible for iOS/Android specific actions to show in desktop browsers\n- Fixed a bug where it was possible for some progress bars to experience a delay in loading\n- Fixed a bug where it was possible for the `OpenedStory`, `SkippedStory`, `DismissedStory`, and `DismissedClips` events to not get recorded in some cases\n- Fixed a bug where it was possible for a previously paused Story to be paused on reopen\n- Fixed a bug where it was possible for an unread Story to be skipped by using the keyboard arrows\n- Fixed a bug where it was possible for the audio of a previous Story to play over the current Story when using the keyboard to navigate\n- Fixed a bug where it was possible for the like state of a clip to be inaccurate in some cases\n- Fixed a bug where it was possible for the swipe up gesture to not open the CTA destination\n\n## **10.4.11** - 2024-09-20\n\nImprovements:\n\n- User attributes now automatically get cleared when a new API key or user ID is provided\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the \"New\" chips to be visible on Stories with read/unread ordering disabled\n\n## **10.4.10** - 2024-09-06\n\nNew Features:\n\n- Added the [`player.disableUrls`](Themes.md#player) and [`clipPlayer.disableUrls`](Themes.md#clip-player) theme properties\n\nImprovements:\n\n- Updated the logic for generating unique ad requests correlators\n\n## **10.4.9** - 2024-09-03\n\nNew Features:\n\n- Added support for image titles in clip collections\n\nImprovements:\n\n- Increased cases where the unmute state is persisted in Chromium browsers\n\n## **10.4.8** - 2024-08-23\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the Storyteller delegate to not be writeable after the first initialization\n\n## **10.4.7** - 2024-08-19\n\nBug Fixes:\n\n- Fixed a bug with the formatting of the ads targeting object\n\n## **10.4.6** - 2024-08-16\n\nImprovements:\n\n- Fall back to navigator share API (if available) if the provided [`onShareButtonTapped`](StorytellerDelegate.md#methods) function returns `null` or isn't a Promise\n\n## **10.4.5** - 2024-07-30\n\nImprovements:\n\n- Pinned Stories now use the same styles as Live Stories (to match the native SDKs)\n- [`clipActionText`](analytics/ClipEvents.md) and [`clipActionUrl`](analytics/ClipEvents.md) properties are now recorded for Clip events\n- Improved error handling when an invalid container ID is supplied\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the `completedStory` event not to be recorded if a Story was already read\n- Fixed a bug where it was possible for the category update of an existing Story row to lead to a console error\n\n## **10.4.4** - 2024-07-26\n\nImprovements:\n\n- Updated the correlator in ads requests URLs so that it's always unique\n\n## **10.4.3** - 2024-07-17\n\nImprovements:\n\n- Updated the ads algorithm to keep requesting ads for a Story even if a previous request failed\n\nBug Fixes:\n\n- Fixed a bug where it was possible for overflow to be disabled when closing the Story player using the browser back button\n\n## **10.4.2** - 2024-07-03\n\nBug Fixes:\n\n- Fixed a bug where it was possible for 1st-party ads to be requested from the wrong endpoint\n\n## **10.4.1** - 2024-06-28\n\nBug Fixes:\n\n- Fixed a bug where it was possible for a read Story to be shown as unread when new pages were just added but the assets were still processing\n\n## **10.4.0** - 2024-06-27\n\nImprovements:\n\n- Replaced the `liveChip.textColor` theme property with [`liveChip.readTextColor`](Themes.md#story-tiles) and [`liveChip.unreadTextColor`](Themes.md#story-tiles)\n- Replaced the `storyTiles.liveChip` theme properties with [`storyTiles.rectangularTile.liveChip`](Themes.md#story-tiles) and [`storyTiles.circularTile.liveChip`](Themes.md#story-tiles)\n- Added support for live clips in browsers that don't support HTTP Live Streaming\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the live chip inside the Clips player to use the default styles instead of the custom theme\n- Fixed a bug where it was possible for the live chip inside the Stories player to use the default styles instead of the custom theme\n\n## **10.3.6** - 2024-06-20\n\nImprovements:\n\n- Updated the ads logic to keep fetching ads for a Story even if a previous request failed\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the first ad in a Story to appear a page later than the provided frequency\n\n## **10.3.5** - 2024-06-18\n\nImprovements:\n\n- Added support for some cookie banners that clear or update local storage when dismissed\n\n## **10.3.4** - 2024-06-13\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the round Story cells to remain empty on Safari iOS 16.4 and below\n\n## **10.3.3** - 2024-06-07\n\nImprovements:\n\n- Updated the maximum lines of the round Story cells titles so they adapt to the chosen line height\n\n## **10.3.2** - 2024-06-06\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the round Story cells borders to get cropped\n- Fixed a bug where it was possible for the round Story cells borders colours to not reflect the read/unread state\n\n## **10.3.1** - 2024-05-31\n\nImprovements:\n\n- Improved console error logs when no Clips or Stories available\n- Improved mouse scrolling experience for Clips on Firefox\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the first Story in a view to skip pre-loading for tenants with a lot of Stories\n- Fixed a bug where it was possible for the ads action button destination to be displayed instead of the advertiser name if no advertiser name was provided\n\n## **10.3.0** - 2024-05-15\n\nNew Features:\n\n- Introduced [first-party ads support](Ads.md#storyteller-first-party-ads)\n- Introduced [linear-gradient support for the round cell borders](Themes.md#story-tiles)\n\nImprovements:\n\n- Improved initialization errors\n- 'New' chip are not shown on pinned Stories so as to match the native SDKs behaviors\n- The tappable area to pause the Clips player has been increased\n\nBug Fixes:\n\n- Fixed a bug where it was possible for a viewed clip to display the 'new' chip\n- Fixed a bug where it was possible for some of the buttons theme properties to not get applied\n- Fixed a bug where it was possible for Stories to get cropped on some tablet screens\n- Fixed a bug where it was possible for the Clips share amount to not persist on navigation\n\n## **10.2.1** - 2024-05-02\n\nBug Fixes:\n\n- Fixed a bug where it was possible for some of the instructions theme properties to not get applied\n\n## **10.2.0** - 2024-04-10\n\nNew Features:\n\n- Added the [`openCategory`](AdditionalMethods.md#opencategory) method to Story views\n- Added support for Clips read/unread ordering\n- Added support for Clips locales using [`Storyteller.User.setLocale`](Users.md#updating-the-clips-locale)\n\nImprovements:\n\n- Removed Storyteller inline styles\n- Updated ad events to use seconds (not milliseconds) for consistency with other events\n- Clips players can now be closed by clicking on the background\n- Improved transition between clips on Safari for smoother experience\n- Adjusted the Story player to accommodate sticky elements like Smart App banners\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the Story lightbox not to open\n- Fixed a bug where it was possible for the Story page to restart after sharing on Safari\n- Fixed a bug where it was possible for the Story progress bars to transition from their previous state upon reopening\n\n## **10.1.3** - 2024-04-16\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the Story player to load indefinitely after closing the instructions screen\n\n## **10.1.2** - 2024-04-03\n\nBug Fixes:\n\n- Fixed a bug where it was possible for round story cells with hidden titles to be horizontally off-centre in Chromium browsers\n\n## **10.1.1** - 2024-03-19\n\nImprovements:\n\n- If the [`lists.row.scrollIndicatorInlineAlignment`](Themes.md#lists) theme property is set to `outside` and the row doesn't have enough items for the scroll indicators to be visible, the empty space where the indicator would normally sit has been removed\n\n## **10.1.0** - 2024-03-08\n\nNew Features:\n\n- The advertiser name property is now supported for AMPHTML ads\n- Stories now don't preload by default (this can be overridden using the [`configuration.preload`](StorytellerListView.md#preload) property at the list level)\n- Added inline clips player component ([`StorytellerClipsPlayerView`](StorytellerListView.md#clips-player-initialization))\n- The Story rows scroll indicator can now be moved outside of the carousel using the [`lists.row.scrollIndicatorInlineAlignment`](Themes.md#lists) theme property\n- The Story rows scroll indicator can now be horizontally aligned with the thumbnails (instead of the whole cell which includes the title) using the [`storyTiles.circularTile.scrollIndicatorBlockAlignment`](Themes.md#story-tiles) theme property\n- The thickness of round cells borders is now configurable using the [`storyTiles.circularTile.unreadStrokeWidth`](Themes.md#story-tiles) and [`storyTiles.circularTile.readStrokeWidth`](Themes.md#story-tiles) theme properties\n- Ad events are now recorded\n\nImprovements:\n\n- Story players can now be closed by pressing the `Esc` button\n- Story players can now be closed by clicking on the background\n- Trying to initialize a Storyteller instance more than once will now throw an error\n- Clicking on an already answered quiz option now moves the user to the next page\n- [`OpenedReason`](Analytics.md#openedreason) now has additional possible values: `tap` and `automaticPlayback`\n- [`DismissedReason`](Analytics.md#dismissedreason) now has additional possible values: `backgroundTapped`, `skippedFinalPage`, `completedFinalPage`, and `backTapped`\n- The following enums used for building custom themes are now exposed: [`Alignment`](Themes.md#story-tiles), [`ButtonAlignment`](Themes.md#player), and [`TextCase`](Themes.md#primitives)\n- The [`IListConfiguration`](StorytellerListView.md#configuration) type is now exposed and can be used to set a list's configuration\n- Updated the type of [`IStorytellerDelegate`](StorytellerDelegate.md#methods) to make the [`onUserActivityOccurred`](StorytellerDelegate.md#methods) callback optional\n- Updated the type of [`IStorytellerDelegate`](StorytellerDelegate.md#methods) to make `customTargeting` optional in [`getAdConfig`](Ads.md#storyteller-ad-manager-integration)\n- Grid thumbnails now use the most appropriate thumbnail size\n- The clip player now automatically pauses on tab change\n- If [`playAllStories`](Themes.md#player) is set to false and the next Story will be skipped, the next Story button is greyed out\n- Various improvements to the clip player transitions and experience\n- Various performance improvements to the Stories player on iOS\n- Various improvements to the loading states and transitions\n\nBug Fixes:\n\n- Fixed a bug where it was possible for the player not to pause when pressing the share button on Safari\n- Fixed a bug where it was possible for a Story page to get skipped after answering a poll\n- Fixed a bug where it was possible for the `OpenedPage` event not to get triggered\n- Fixed a bug where it was possible for the player to pause when a quiz question wasn't answered\n- Fixed a bug where it was possible for a previously opened Story to appear briefly when opening another Story\n- Fixed a bug where it was possible for Story audio to keep playing after the player was closed\n- Fixed a bug where it was possible for a Story to show a grey screen when navigating backwards or quickly\n- Fixed a bug where it was possible for the wrong [`OpenedReason`](Analytics.md#openedreason) to be recorded when opening a Story or Page\n- Fixed a bug where it was possible for clip players to be appended to the DOM more than once on SPAs\n- Fixed a bug where it was possible for the clip player back button to scroll users back to the top of the page\n- Fixed a bug where it was possible for poll results to clash with the background\n- Fixed a bug where it was possible for OneBox Stories not to autoplay in the Google app\n- Fixed a bug where it was possible for the live chip position to be wrong when the row titles were hidden\n\n## **10.0.4** - 2024-02-02\n\nBug Fixes:\n\n- Fixed a bug where it was possible for short image polls captions to overlap with the background\n\n## **10.0.3** - 2024-01-31\n\nBug Fixes:\n\n- Fixed a bug where it was possible for OneBox Stories not to send events analytics to Amplitude\n\n## **10.0.2** - 2024-01-26\n\nBug Fixes:\n\n- Fixed a bug where it was possible for OneBox Stories not to send engagement units events analytics\n\n## **10.0.1** - 2024-01-10\n\nBug Fixes:\n\n- Fixed a console error about `navigator` being undefined\n- Fixed a bug where the gradient behind the Story titles on rectangular tiles didn't respect padding preferences\n\n## **10.0.0** - 2024-01-10\n\nNew Features:\n\n- Added support for [Clips](views/index.md)\n- Introduced the [`configuration`](StorytellerListView.md#configuration) object for list views\n- Implemented tracking for [ad events](analytics/AdEvents.md)\n\nImprovements:\n\n- Added support for `instanceMethod` and `escapeKeyPressed` in the analytics events' [`DismissedReason`](Analytics.md#dismissedreason) property\n- Added support for `tap` and `automaticPlayback` in the analytics events' [`OpenedReason`](Analytics.md#openedreason) property\n- Added [`isInitialized`](AdditionalMethods.md#isinitialized) and [`isPlayerVisible`](AdditionalMethods.md#isplayervisible) properties to the global Storyteller instance\n- Added the [`dismissPlayer`](AdditionalMethods.md#dismissplayer) method to the global Storyteller instance\n- Added the `enableEventTracking` and `disableEventTracking` methods to the global Storyteller instance\n- Added the [`enableLogging`](AdditionalMethods.md#enablelogging) method to the global Storyteller instance\n- Added `IListViewDelegate` type export\n- Moved the [`openPage`](AdditionalMethods.md#openpage) and [`openStory`](AdditionalMethods.md#openstory) methods from the list views to the global Storyteller instance\n- Renamed the `onShareButtonClicked` callback to [`onShareButtonTapped`](StorytellerDelegate.md#methods) and moved it to the global Storyteller delegate\n- Renamed the `onStoriesDataLoadStarted` callback to [`onDataLoadStarted`](StorytellerListViewDelegate.md#delegate-methods)\n- Renamed the `onStoriesDataLoadComplete` callback to [`onDataLoadComplete`](StorytellerListViewDelegate.md#delegate-methods)\n- Renamed the `onStoryDismissed` callback to [`onPlayerDismissed`](StorytellerListViewDelegate.md#delegate-methods)\n- Moved the [`getAdConfig`](Ads.md#storyteller-ad-manager-integration) method to the global Storyteller delegate\n- Moved the [`onUserActivityOccurred`](StorytellerDelegate.md#methods) callback to the global Storyteller delegate\n- Removed the `tileBecameVisible` callback\n- Removed the `onError` callback\n- Updated list views to derive their basename from their categories or collection\n- Improved dark mode support and default styles\n- Various performance and playback improvements\n\nBug Fixes:\n\n- Fixed a bug where the `OpenedPage` event did not fire on Stories with a single Page\n- Fixed a bug where the `SkippedStory` event did not fire when the final Page of a Story was skipped\n- Resolved playback issues on quizz Pages\n\n## **8.9.4** - 2023-12-18\n\nImprovements:\n\n- Adding support for dark mode placeholders by using the [`lists.backgroundColor`](Themes.md#lists) theme property to set the placeholder styles\n- Preventing Content Layout Shift when loading grid items\n\n## **8.9.3** - 2023-12-08\n\nImprovements:\n\n- Adding `title.show` theme property to show/hide Story titles on all tiles\n- Removed `circularTile.title.hide` theme property\n\nBug Fixes:\n\n- Fixing a bug where it was possible for round Story tiles with hidden titles to get cropped\n\n## **8.9.2** - 2023-12-01\n\nBug Fixes:\n\n- Fixing a bug where it was possible for the player to load indefinitely after closing the instructions screen\n\n## **8.9.1** - 2023-11-30\n\nBug Fixes:\n\n- Adding TypeScript declaration file export to `package.json`\n\n## **8.9.0** - 2023-11-22\n\nBug Fixes:\n\n- Fixing a bug where it was possible for auto-advancing ads to not show a progress bar\n- Fixing a bug where it was possible for action buttons to open the wrong URL in Stories with multiple action buttons\n\n## **8.8.7** - 2023-10-26\n\nBug Fixes:\n\n- fixing a bug where it was possible for stories not to play when the instructions screen was hidden via the theme\n\n## **8.8.6** - 2023-10-25\n\nBug Fixes:\n\n- Fixing a bug where it was possible for OpenedStory events not to be fired in certain scenarios\n- Fixing a bug where it was possible for OpenedPage events not to be fired in certain scenarios\n- Fixing a bug where it was possible for PreviousPage events to be fired at an incorrect moment\n- Fixing a bug where it was possible for the story player to be incorrectly aligned on certain mobile browsers\n- Fixing a bug where it was possible for playback to stall on certain mobile browsers\n\n## **8.8.5** - 2023-10-24\n\nImprovements:\n\n- Moving the Action button below the player on desktop\n- Reducing the size of the Action button on mobile browsers to reduce the chance of collision with content\n\n## **8.8.4** - 2023-10-17\n\nImprovements:\n\n- Fixing the category query parameter\n\n## **8.8.3** - 2023-10-13\n\nBug Fixes:\n\n- Fixing a bug where it was possible for Current Category to be reported as empty\n\n## **8.8.2** - 2023-10-13\n\nImprovements:\n\n- Added support for returning `externalId`\n\nBug Fixes:\n\n- When no Category is matched, `CurrentCategory` no longer reports `\"Home\"`\n\n## **8.8.1** - 2023-10-12\n\nImprovements:\n\n- Fixing a bug where it was possible for `externalId` for Categories for Ads Targeting\n- Fixing a bug where it was possible for Current Category to be reported incorrectly for Analytics\n\n## **8.8.0** - 2023-10-11\n\nNew Features:\n\n- Adding [fixed story order support](StorytellerListView.md#story-ordering)\n- Adding [pinned story support](StorytellerListView.md#story-ordering)\n\nImprovements:\n\n- Fixing Story navigation bugs\n- Fixing instruction page bugs\n- Adding missing `title` attribute in iframes\n\n## **8.7.0** - 2023-10-05\n\nNew Features:\n\n- Adding support for ads between pages\n\nImprovements:\n\n- Adding `SkippedPage` Analytics Event\n- Adding `CompletedPage` Analytics Event\n- Adding `Page Title` to all events\n- Adding missing event properties\n- Updating Story Title display\n- Adding missing `alt` attributes\n- Fixing images aspect ratio errors\n\n## **8.6.0** - 2023-09-20\n\nImprovements:\n\n- Removing the # from the URL when closing a Story.\n\nBug Fixes:\n\n- Fixing a muting/unmuting bug when going back into a Story.\n- Fixing errors coming from Google Ad Manager.\n\n## **8.5.3** - 2023-09-05\n\nImprovements:\n\n- Validate `AdConfig` before passing it to Story View\n\n## **8.5.2** - 2023-08-30\n\nBug Fixes:\n\n- Fixed module exports\n\n## **8.5.1** - 2023-08-29\n\nBug Fixes:\n\n- Fixed Storyteller usage in Jest tests\n\n## **8.5.0** - 2023-08-17\n\nNew Features:\n\n- Adding `useGoogleWebStoryUrls` parameter to `StorytellerStoriesGridView`\n\nImprovements:\n\n- Reduced SDK budle size by 50%, leading to faster app performance.\n\nBug Fixes:\n\n- Fixing a bug where it was possible for the navigation arrows on desktop to not appear.\n- Fixing a bug where it was possible for Story transition animations to not appearing.\n- Fixing a bug where it was possible for Stories to fail to open when opened via a URL.\n\n## **8.4.2** - 2023-07-31\n\nNew Features:\n\n- Adding the ability to open a fully AMPHTML compatible version of stories when selecting an item from a StorytellerStoriesRowView\n\nBug Fixes:\n\n- In certain situations, the `OpenedStory` and `OpenedPage` events might not fire. This is now fixed.\n\n## **8.4.1** - 2023-07-07\n\nNew Features:\n\n- Allow the ability to [set a `theme` on an individual StorytellerStoriesRowView or StorytellerStoriesGridView](StorytellerListView.md#theme)\n\n## **8.4.0** - 2023-06-30\n\nImprovements:\n\n- Standardizing the behavior of quizzes with our native SDKs\n- Adding additional analytics properties\n\nBug Fixes:\n\n- Fixing a bug where it was possible for the \"Share your Result\" button on quizzes to be black in Safari\n- Fixing a bug where videos could fail to play if a user hadn't interacted with the browser\n- Fixing a bug where it was possible for a Page's sound to continue playing after the Story player was dismissed\n\n## **8.2.0** - 2023-06-23\n\nNew Features:\n\n- Adding support for Audience Targeting and Personalization - see [Users](Users.md) for more information\n\nImprovements:\n\n- Adding additional analytics properties\n\n## **8.1.0** - 2023-06-01\n\nImprovements:\n\n- Internal state management and minor bugfixes\n\n## **8.0.0** - 2023-04-26\n\nNew Features:\n\n- Added a [rectangular tile gradient theme property](Themes.md#story-tiles)\n- Added support for `customInstanceHost`\n\nImprovements:\n\n- Added support for compiling on case-sensitive filesystems\n- Engagement units are now fetched from the view instead of the API\n- Updated the quiz renderer to use a more specific grid layer selector\n\n## **7.9.2** - 2023-04-17\n\nNew Features:\n\n- Adding `useGoogleWebStoryUrls` parameter to `StorytellerListView`\n\n## **7.9.1** - 2023-01-17\n\nBug Fixes:\n\n- Fixing bug causing the skip story buttons to not appear on Safari\n\n## **7.9.0** - 2023-01-16\n\nImprovements:\n\n- Add theme property to [hide the gradient on rectangular thumbnails](Themes.md#story-tiles)\n\n## **7.8.5** - 2023-01-13\n\nBug Fixes:\n\n- Stop the flash of images when coming back from swipe up\n\n## **7.8.4** - 2023-01-12\n\nBug Fixes:\n\n- Story player improvements\n\n## **7.8.2** - 2022-12-13\n\nBug Fixes:\n\n- Fixing bug where the PreviousPage event would not fire\n- Fixing bug where the SkippedStory event would not fire\n\n## **7.8.1** - 2022-12-13\n\nBug Fixes:\n\n- Fixing bug where the player would freeze when opened\n- Fixing bug where the PreviousPage event would not fire\n\n## **7.8.0** - 2022-12-05\n\nBug Fixes:\n\n- Ensuring circular live story border matches theme color\n- Improving loading behavior when opening stories\n\n## **7.7.1** - 2022-11-09\n\nBug Fixes:\n\n- Fixing `font` theme property\n- Fixing `instructions.icons` theme property\n\n## **7.7.0** - 2022-09-28\n\nImprovements:\n\n- Allow quizzes to be rendered outside stories\n- Adding [`showWebStoriesIcon`](Themes.md#story-tiles) theme property\n\n## **7.6.0** - 2022-09-23\n\nBug Fixes:\n\n- Fixing bug where thumbnails would sometimes fail to load\n\nImprovements:\n\n- Adding [`displayLimit`](StorytellerListView.md#displaylimit) to rows and grids\n- Exposing [`contentLength`](analytics/StoryEvents.md) in user activity delegate callback\n\n## **7.5.0** - 2022-08-29\n\nBug Fixes:\n\n- Lazy load Story tile thumbnails\n- Fixing issue where the navigation buttons could disappear\n- Stop player going back 2 Stories when back button pressed\n\nImprovements:\n\n- Improve caching for static assets\n\n## 7.4.5 - 2022-08-22\n\nBug Fixes:\n\n- Fixing bug with scroll indicator fade theming\n- Fixing bug when applying corner radius theme property\n\n## 7.4.3 - 2022-08-17\n\nBug Fixes:\n\n- Fixing quiz score placement when sharing disabled\n- Fixing bug where instructions screen took multiple clicks to dismiss\n\n## 7.4.2 - 2022-08-17\n\nBug Fixes:\n\n- Don't reorder Stories when player is closed\n- Fix NPM type definitions\n\nImprovements:\n\n- Use simple HTTP Requests\n\n## 7.4.1 - 2022-07-29\n\nNew Features:\n\n- Adding [`openStory`](AdditionalMethods.md#openstory) and [`openPage`](AdditionalMethods.md#openpage) methods\n\n## 7.4.0 - 2022-07-29\n\nNew Features:\n\n- Support [CommonJS and ESM](getting-started/npm.md#import-the-sdk-and-styles)\n\nBug Fixes:\n\n- Fixing live chip theme issues\n\n## 7.3.5 - 2022-07-15\n\nBug Fixes:\n\n- Don't show share results button if share API not available\n- Fixing bug when returning from swipe up\n- Make sure `externalApp` swipe ups are recorded correctly\n\n## 7.3.4 - 2022-07-13\n\nImprovements:\n\n- Improving support for older browsers\n\n## 7.3.3 - 2022-07-11\n\nBug Fixes:\n\n- Polls theme fixes\n\n## 7.3.1 - 2022-07-08\n\nImprovements:\n\n- Make sure player Stories reorder when player closed\n\nBug Fixes:\n\n- Fixing corrupt svg console errors\n\n## 7.3.0 - 2022-06-23\n\nDeprecation and Changes:\n\n- Removing `showStoryTitle` theme property\n- Adding `showStoryIcon` theme property\n\n## 7.2.4 - 2022-06-20\n\nImprovements:\n\n- Improving open Story transitions\n- Hide Quiz share button when share buttons hidden\n\nBug Fixes:\n\n- Fixing issue with new indicator always showing on rectangular tiles\n\n## 7.2.2 - 2022-06-01\n\nBug Fixes:\n\n- Fixing issues with NPM type definitions\n\n## 7.2.1 - 2022-05-31\n\nBug Fixes:\n\n- Stop scroll to top when player closed\n\n## 7.2.0 - 2022-05-13\n\nBug Fixes:\n\n- Fixing issues with NPM package\n\n## 7.1.2 - 2022-05-12\n\nImprovements:\n\n- Updating package.json\n\n## 7.1.1 - 2022-05-11\n\nNew Features:\n\n- Added [NPM support](getting-started/npm.md)\n\n## 7.1.0 - 2022-05-02\n\nNew Features:\n\n- Added support for Live Stories\n\n## 7.0.0 - 2022-04-07\n\nNew Features:\n\n- Added support for [Trivia Quizzes](views/engagement.md)\n\nImprovements:\n\n- Made implementing custom themes even easier\n\n## 2.2.0 - 2022-03-23\n\nImprovements:\n\n- Hide share button on browsers that don't support `navigator.share`\n- Make `externalId` optional\n- Allow Ad frequency to be configured\n\n## 2.1.0 - 2022-03-11\n\nImprovements:\n\n- Adjust tile height to fill parent container\n- Send [`pollAnswerId`](analytics/PollEvents.md) in analytics events\n- Send all properties to analytics endpoint\n\n## 2.0.1 - 2022-02-16\n\nBug Fixes:\n\n- Fixing Story Page issues\n\n## 2.0.0 - 2022-02-09\n\nImprovements:\n\n- Adding [Grid Layout](StorytellerGridView.md)\n- Theme updates\n\nNew Features:\n\n- Adding support for [unread indicator gradient](Themes.md#story-tiles)\n\n## 1.17.1 - 2022-01-18\n\nImprovements:\n\n- Improving swipe behavior\n- Show navigation arrows on touchscreen laptops\n\nBug Fixes:\n\n- Stopping JSONParseErrors being thrown for empty responses\n- Fixing missing API key 401s\n\n## 1.17.0 - 2021-11-19\n\nNew Features:\n\n- Added full support for [Categories](StorytellerListView.md#categories-stories-only)\n- Added support for [ads](Ads.md)\n\n## 1.16.0 - 2021-11-02\n\nNew Features:\n\n- Added the ability to swipe down to dismiss a Story\n- Added the ability for share links to open a specific Page (instead of just the first Page in the Story)\n- Added a [`playAllStories`](Themes.md#player) option to the theme which will not exit the Story player when the user reaches the end of their unread Stories - but rather keep them in the Stories experience until they see every Story in the row\n\nBug Fixes:\n\n- Fixed an issue which could cause Polls not to display in certain scenarios\n\n## 1.15.0 - 2021-10-22\n\nImprovements:\n\n- Hiding 'i' button when video fails to play\n\nBug Fixes:\n\n- Stop video failed to play message appearing when a video successfully plays\n\nNew Features:\n\n- Recording share success events\n\n## 1.14.0 - 2021-10-21\n\nBug Fixes:\n\n- Fixing bug where Poll answer percentages display incorrectly\n\n## 1.13.0 - 2021-10-19\n\nImprovements:\n\n- Preventing background media from being cropped\n\n## 1.12.0 - 2021-10-18\n\nBug Fixes:\n\n- Using the correct value for `storyReadStatus` in analytic events\n- Fixing issue where Story titles are shared/duplicate sharing URLs are shared when tapping share button\n\nImprovements:\n\n- Adding information about `VotedPoll` event to the docs\n- Updating to open Story immediately when tapping/clicking Story tile instead of showing loading spinners\n\n## 1.11.0 - 2021-10-15\n\nBug Fixes:\n\n- Fixing sharing instructions issues\n\n## 1.10.0 - 2021-10-12\n\nImprovements:\n\n- Removes the border around buttons in the Story player\n\n## 1.9.0 - 2021-10-07\n\nBug Fixes:\n\n- Fixing bug where users can vote for a Poll more than once\n\n## 1.8.0 - 2021-10-05\n\nImprovements:\n\n- Adding theme option to hide Story titles\n\nBug Fixes:\n\n- Persisting mute state throughout Stories\n- Fixing CORS issues\n\n## 1.7.0 - 2021-09-24\n\nBug Fixes:\n\n- Stopping the wrong Story from being shown briefly when opening a share link\n- Disabling the 'previous page' button on the first Page of the first Story\n- Fixing issue where Story row would not load on iOS 12\n\n## 1.6.0 - 2021-09-23\n\nImprovements:\n\n- Always displaying the mute/unmute icon in player\n- Adding text property to `onShareButtonClicked()` delegated method\n- Allow 3 lines for the Story title when using circular tiles\n\nBug Fixes:\n\n- Fixing instructions screen layout and icons on desktop\n- Fixing issue with missing navigation arrows and black background when refreshing/arriving from shared link\n\n## 1.5.0 - 2021-09-17\n\nBug Fixes:\n\n- Stop player closing when navigating backwards\n- Sort all Story rows when player is closed\n- Stop player from continuing in background after being closed\n\nNew Features:\n\n- Adding share delegate method\n- Adding docs for share callback\n\nImprovements:\n\n- Hide share button if `navigator.share` doesn't exist\n- Don't hide share button if `onShareButtonClick` callback is defined\n\n## 1.4.0 - 2021-09-16\n\nBug Fixes:\n\n- Fixing Poll styling\n- Fixing ad overlay appearing over Story view\n\n## 1.3.0 - 2021-09-09\n\nBug Fixes:\n\n- Fixing desktop player not pausing on share\n- Fixing left scroll arrow\n- Only show read Stories and fix player opening unexpectedly\n- Don't open player until correct Story has loaded\n- Fixing bug when opening same Story after dismissing it\n- Setting opacity on tile loading\n- Fixing style import\n- Hide mute/unmute text\n\nNew Features:\n\n- Adding `tileLoading` state to tiles\n\n## 1.2.0 - 2021-09-07\n\nNew Features:\n\n- Adding properties to row theme\n\nBug Fixes:\n\n- Fixing instruction icons\n\nDeprecations and Changes:\n\n- Switch to using query string params instead of headers in API requests\n- Updating row theme docs\n\n## 1.1.0 - 2021-09-02\n\nBug Fixes:\n\n- Fixing Poll styling\n- Fixing ad overlay appearing over Story view\n", "copy_markdown_include_header": false, "base_path": "", "ai_dir": "ai", "missing_payload_behavior": "empty"}