Skip to main content
All CollectionsUGC - Developer GuidesGeneric Javascript integration
Embedding a Static Flow on your website
Embedding a Static Flow on your website

How to embed a Flow into your website - the generic guide

Updated over a year ago

To display a Flow you've created in Flowbox you need to add a couple of small snippets to your website's templates.

Start out by including the flowbox.js  script on your page by copying this snippet and pasting it in the <head>  element. This script declares all the required methods for Flowbox to run, so it always needs to be executed first:

<script>
  (function(d, id) {
    if (!window.flowbox) { var f = function () { f.q.push(arguments); }; f.q = []; window.flowbox = f; }
    if (d.getElementById(id)) {return;}
    var s = d.createElement('script'), fjs = d.scripts[d.scripts.length - 1]; s.id = id; s.async = true;
    s.src = 'https://connect.getflowbox.com/flowbox.js';
    fjs.parentNode.insertBefore(s, fjs);
  })(document, 'flowbox-js-embed');
</script>

Then, you can go ahead and use the window.flowbox function to display your Flows. To render a Flow on your webpage, copy and paste this snippet wherever you want the Flow to show up:

<div id="js-flowbox-flow"></div>
<script>
  window.flowbox('init', {
    container: '#js-flowbox-flow',
    key: 'YOUR FLOW KEY',
    locale: 'language-COUNTRY'
  })
</script>

  • The container property refers to an element on your page, in this case the div element with the "js-flowbox-flow" id.
    ​

  • The key property is the Flow key. The easiest way to find this is by copying it from the "Copy Flow Key" option in the meatball (three-dot) menu in the Flows section:

  • The locale property needs to be a combination of language and region codes: e.g. sv-SE or es-ES. It serves two purposes. Firstly, it is used to translate the texts within the Flow to the selected language, except for the CTA button, which needs to be changed separately in the catalog configuration modal window or in the posts themselves. Secondly, it specifies the catalog from which the Flow should fetch data for assigned products, such as product titles, currency, and product links.

Please also make sure to use language-COUNTRY instead of language_COUNTRY. For more info on which languages we support, please visit this page. If you pass in an unsupported locale, buttons and text will be displayed in English.

Content Security Policy (CSP) Error

Content Security Policy (CSP) is a W3C standard providing a layer of protection against Cross-Site Scripting (XSS). CSP policy allows blocking/allowing content from specified domains and avoiding the content coming from unapproved origin.

If you see an error message that states that the Flowbox script could not load due to Content Security Policy, you will need to add Flowbox to your CDN whitelist.

Additional resources

Did this answer your question?