Join our mailing list! No, thanks
How to develop embedded webpages for layers

Here are some technical details when creating a web page to be embedded in the layer editor:

1. Have a transparent background

Transparency should not be handled with a green alpha channel (or chroma key) but rather have the css transparency enabled and applied to the body of the HTML page.
Either add the following css rule:

body {

or define it inline:

<body style="background-color:rgba(0,0,0,0);">

2. When embedding the web page on, user interactions are not allowed. (Think of it as the web page being opened on a browser on the server side)

This has two consequences:

  • The page embedded on can't be clicked or interacted with in any way
  • Settings can't be chosen nor memorized with any local data storing method (e.g. no settings saved with cookies)

Specific settings for the embedded page have to be inserted inside the URL query string or path structure, e.g. https://yourpagetoembed?setting1=test&setting2=option 


Regarding the "X-Frame-Options" error

A "X-Frame-Options" error will be displayed as follow:

"Refused to display ''https://your-website' in a frame because it set 'X-Frame-Options' to 'XXX'"

To correct this error, change the response headers and/or the metadata of your website if you have access to it. *If you don't, it means that embed mode is blocked by the website policy*

• "X-Frame-Options" header: allowed value is "ALLOWALL" or "ALLOW-FROM" if you just want to authorize
• "Access-Control-Allow-Origin" header: allowed value is "*". You can also remove the header or add to it.

More info: