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.

Sample Apps

iOS: https://git.tickaroo.com/pub/liveblog-embed-demo-ios
Android: https://git.tickaroo.com/pub/tickaroo-android-web-embed-demo