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.
Recommended dimensions
Modal integration (recommended)
| Device | Width | Height |
|---|---|---|
| Desktop | 1160 px | 700 px |
| Tablet and mobile (full screen) | 100% | 100dvh |
Embedded integration
| Device | Width | Height |
|---|---|---|
| Desktop | 1200 px | 720 px |
| Mobile | 100% | 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:
| Layout | Iframe width |
|---|---|
| Desktop | 1135 px and above |
| Tablet | 701 px – 1134 px |
| Mobile | 700 px and below |
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.