Every layout beyond the plain inline form uses the script embed; the layout name is passed as the second argument to formsapp(), and layout-specific settings go in the options object (the third argument).
| Layout value | Also known as | Best for |
|---|---|---|
'fullscreen' | Full page | A dedicated page or route for the form. |
'popover' | Chatbot | A chat-bubble widget in the corner of the screen. |
'sidetab' | Side tab | A small tab on the screen edge that expands into the form. |
'popup' | Pop-up | A modal, opened by click, page load, or after a delay. |
'slider' | Slider | A panel that slides in from the screen edge. |
The pop-up, slider, chatbot, and side-tab layouts share the same button and autoOpen options:
| Option | Applies to | Description |
|---|---|---|
button.color | Pop-up, slider, chatbot, side tab | Hex color of the trigger button, for example '#ff9e24'. |
button.text | Pop-up, slider, side tab | Label shown on the trigger button. |
autoOpen.action | Pop-up, slider, chatbot, side tab | 'onpageload' to open immediately, or 'aftersettime' to open after a delay. |
autoOpen.setTimeSeconds | Pop-up, slider, chatbot, side tab | Delay in seconds, used with 'aftersettime'. |
openingAnimation.entrance / openingAnimation.exit | Pop-up, slider | An animate.css class name, for example 'animate__fadeIn' / 'animate__fadeOut'. |
If autoOpen is omitted, the widget only opens when a visitor clicks its trigger button (or, for pop-ups, you can omit the button entirely and rely on autoOpen alone. See Pop-up).