Embed a Liveblog into your App

The best way to integrate a liveblog into mobile apps are webviews. You can use the same Embed Code as in your webpage or load a url which already embeds the liveblog.

App/WebView origin whitelist (must-read for app integrations)

Our Liveblog embed only runs if the request origin matches your Enabled domains. Configure this under: Settings → Integration → Enabled domains.

  • What we check: the request origin (equivalent to window.location.origin → scheme + host [+ port]) against your Enabled domains.
  • Typical app cases: 1) Load a normal https:// URL in a WebView 2) Load local HTML inside the WebView

Android specifics

  • Hosted page: use webView.loadUrl("https://your-domain/..."). Ensure that host is in Enabled domains.
  • Local HTML:
    • loadDataWithBaseURL(baseUrl, html, ...) with baseUrl set to your https:// domain that’s in Enabled domains; requests will use that origin.
    • Or use WebViewAssetLoader with setDomain to serve local assets under an https:// host. Add that host to Enabled domains.

iOS specifics

  • Hosted page: use WKWebView and load an https:// URL; add that domain to Enabled domains.
  • Local HTML: loadHTMLString(embedHtml, baseURL: httpsBaseUrl) works if httpsBaseUrl points to a domain that’s in Enabled domains. The WebView will use the baseURL origin for requests.

Quick troubleshooting

  • In the WebView dev tools, run window.location.origin and compare to your Enabled domains.
  • Ensure you are loading over https:// (not file://).
  • Check redirects: did the page land on a different host than expected?

For sample apps, see the links at the bottom of this page.

We recommend setting commentsMode to "inline" when embedding in a WebView.

The default comment display opens the full comment thread in a modal overlay. Overlays do not work properly inside a WebView — the limited viewport, missing scroll locking, and stacking/z-index constraints mean the modal cannot render reliably. The "inline" mode expands the comment thread in place within the page flow, avoiding the overlay entirely.

You can set this per embed via the tag parameter, or as a default in your theme.

Sample Apps

iOS: https://github.com/Tickaroo/liveblog-embed-demo-ios
Android: https://github.com/Tickaroo/liveblog-embed-demo-android