Skip to main content

Layout and dimensions

The iframe's size decides whether the plugin renders its desktop, tablet or mobile layout. Use the recommended dimensions below to get the intended layout.

DeviceWidthHeight
Desktop1160 px700 px
Tablet and mobile (full screen)100%100dvh

Embedded integration​

DeviceWidthHeight
Desktop1200 px720 px
Mobile100%768 px

Use the embedded layout for dedicated VTO pages or sections. On mobile, use 100% × 768 px when the plugin stays inline inside the page.

Breakpoints​

The plugin picks its layout from the iframe width, not the browser window width:

LayoutIframe width
Desktop1135 px and above
Tablet701 px – 1134 px
Mobile700 px and below
Avoid sizes near a breakpoint

If the iframe is smaller than recommended, or very close to a breakpoint, the plugin may switch to a smaller layout (for example from desktop to tablet). Always test with the recommended dimensions. Use Integration mode to find sizing problems.

Overlay behavior by device​

Desktop (≥ 1135 px): show the plugin in a centered modal or popup. Users stay in the context of your page. Always include a close button.

Tablet and mobile (≤ 1134 px): show the plugin full screen:

  • The iframe fills 100% of the viewport width and height (100dvh).
  • Lock page scroll while it's open (document.body.style.overflow = 'hidden').
  • Include a close button or gesture so users can exit.

The responsive modal pattern implements all of this.

Mobile apps​

In a mobile WebView, show the plugin full screen or in a full-height sheet. For the native SDK's layout rules, see iOS Native SDK.