Embed Reference

Embed Reference

Permanent reference implementations for every Timepath embed supported in production. Use these examples to validate Timepath integrations in your CMS, website or publishing platform.

Each page below renders a permanent Timepath fixture through the real production integration — the actual iframe, or the actual Script bundle mounted into the page — beside the exact code that produced it. The URLs are stable and the fixtures are maintained, so they are safe to point a regression suite at.

Compatibility matrix

All 10 Timepath products embed as an iFrame. 6 of them also ship a Script renderer, which mounts the experience into your own DOM instead of a frame. A dash means the combination is not supported in production today.

Timepath products against the two production embed methods. Every supported combination links to its permanent reference implementation.
ProductiFrameScript
TimelineView example — Timeline, iFrameView example — Timeline, Script
LiveblogView example — Liveblog, iFrameView example — Liveblog, Script
CollectionView example — Collection, iFrameView example — Collection, Script
QuizView example — Quiz, iFrameView example — Quiz, Script
PollView example — Poll, iFrameView example — Poll, Script
SurveyView example — Survey, iFrameNot supported — Survey, Script
VoicesView example — Voices, iFrameNot supported — Voices, Script
Social StoryView example — Social Story, iFrameNot supported — Social Story, Script
GeoStoryView example — GeoStory, iFrameView example — GeoStory, Script
Data StoryView example — Data Story, iFrameNot supported — Data Story, Script

16 reference implementations in total. Support is verified against the Timepath embed platform itself rather than against documentation.

Height behaviour, by format

The Script integration has no frame and therefore no height to negotiate. For iFrame, formats fall into three groups — worth knowing before you write one resize listener and assume it covers all ten.

  • postMessage height

    The embed posts its rendered height to the parent window as content changes. The official resize helper below grows the iframe to match.

    Timeline · Liveblog · Collection · Quiz · Poll · Survey · Social Story

  • postMessage height (Voices shape)

    Voices posts a different message shape from the other formats, so it needs its own listener rather than the shared helper.

    Voices

  • Fixed height

    This format posts no height message. It renders to fill the frame it is given, so the height you set is the height it uses.

    GeoStory · Data Story

Automating against these pages

Every URL in the matrix is also published as JSON at /documentation/embed-examples/manifest.json, generated from the same configuration that builds these pages. It carries the supported methods, the stable URLs and each fixture’s Timepath content ID, so an integration suite can enumerate what to test rather than hardcoding a list that goes stale.

Full embedding documentation

Subscribe for updates

Product news, newsroom stories and new formats — occasionally, never spam.