Skip to content
Last updated

Embed options

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 valueAlso known asBest for
'fullscreen'Full pageA dedicated page or route for the form.
'popover'ChatbotA chat-bubble widget in the corner of the screen.
'sidetab'Side tabA small tab on the screen edge that expands into the form.
'popup'Pop-upA modal, opened by click, page load, or after a delay.
'slider'SliderA panel that slides in from the screen edge.

Shared button and auto-open settings

The pop-up, slider, chatbot, and side-tab layouts share the same button and autoOpen options:

OptionApplies toDescription
button.colorPop-up, slider, chatbot, side tabHex color of the trigger button, for example '#ff9e24'.
button.textPop-up, slider, side tabLabel shown on the trigger button.
autoOpen.actionPop-up, slider, chatbot, side tab'onpageload' to open immediately, or 'aftersettime' to open after a delay.
autoOpen.setTimeSecondsPop-up, slider, chatbot, side tabDelay in seconds, used with 'aftersettime'.
openingAnimation.entrance / openingAnimation.exitPop-up, sliderAn 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).

Choose a layout