{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["cards","card"]},"type":"markdown"},"seo":{"title":"Embed options","description":"Build integrations, automate workflows, and manage forms and responses programmatically with the forms.app API.","siteUrl":"https://developers.forms.app","image":"/assets/formsapp-developer-docs.6ffba4f5ff7d394698661bcdb0ed2a8452f27acaf4e82754e5d0f4109563471c.9c1bb791.png","lang":"en-US","projectTitle":"forms.app Developer Docs","llmstxt":{"sections":[{"title":"llmtxt for forms app documents","includeFiles":["**/*"],"excludeFiles":[]}]},"jsonLd":{"@context":"https://schema.org","@type":"Organization","additionalType":"https://en.wikipedia.org/wiki/Software_as_a_service","url":"https://forms.app","name":"forms.app","logo":"https://cdn.forms.app/icons/all/brands/formsapp-logo-dark.svg","description":"forms.app is a free online form builder designed for teams. forms.app offers a modern, easy-to-use form builder and allows unlimited responses and team members.","foundingDate":"2018","sameAs":"https://linkedin.com/company/formsapp","contactPoint":{"@type":"ContactPoint","contactType":"Customer service","email":"support@forms.app","url":"https://forms.app/en/contact-us"}}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"embed-options","__idx":0},"children":["Embed options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every layout beyond the plain inline form uses the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embeds/script-embed"},"children":["script embed"]},"; the layout name is passed as the second argument to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["formsapp()"]},", and layout-specific settings go in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["options"]}," object (the third argument)."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Layout value"},"children":["Layout value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Also known as"},"children":["Also known as"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Best for"},"children":["Best for"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'fullscreen'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embeds/embed-options/fullscreen"},"children":["Full page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A dedicated page or route for the form."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'popover'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embeds/embed-options/chatbot"},"children":["Chatbot"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A chat-bubble widget in the corner of the screen."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'sidetab'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embeds/embed-options/sidetab"},"children":["Side tab"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A small tab on the screen edge that expands into the form."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'popup'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embeds/embed-options/popup"},"children":["Pop-up"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A modal, opened by click, page load, or after a delay."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'slider'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embeds/embed-options/slider"},"children":["Slider"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A panel that slides in from the screen edge."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shared-button-and-auto-open-settings","__idx":1},"children":["Shared button and auto-open settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The pop-up, slider, chatbot, and side-tab layouts share the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["button"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autoOpen"]}," options:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Applies to"},"children":["Applies to"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["button.color"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pop-up, slider, chatbot, side tab"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hex color of the trigger button, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'#ff9e24'"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["button.text"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pop-up, slider, side tab"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Label shown on the trigger button."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autoOpen.action"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pop-up, slider, chatbot, side tab"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'onpageload'"]}," to open immediately, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'aftersettime'"]}," to open after a delay."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autoOpen.setTimeSeconds"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pop-up, slider, chatbot, side tab"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delay in seconds, used with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'aftersettime'"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["openingAnimation.entrance"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["openingAnimation.exit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pop-up, slider"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://animate.style/"},"children":["animate.css"]}," class name, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'animate__fadeIn'"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'animate__fadeOut'"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autoOpen"]}," alone. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/embeds/embed-options/popup#without-a-trigger-button"},"children":["Pop-up"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-a-layout","__idx":2},"children":["Choose a layout"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":2,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Full page","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/embeds/embed-options/fullscreen"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The form fills the entire viewport."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Chatbot","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/embeds/embed-options/chatbot"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A chat-bubble button that opens the form in a compact window."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Side tab","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/embeds/embed-options/sidetab"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A small tab on the edge of the screen."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Pop-up","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/embeds/embed-options/popup"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A modal dialog with configurable open triggers and animation."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Slider","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/embeds/embed-options/slider"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A panel that slides in from the screen edge."]}]}]}]},"headings":[{"value":"Embed options","id":"embed-options","depth":1},{"value":"Shared button and auto-open settings","id":"shared-button-and-auto-open-settings","depth":2},{"value":"Choose a layout","id":"choose-a-layout","depth":2}],"frontmatter":{"seo":{"title":"Embed options"}},"lastModified":"2026-08-18T10:09:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/embeds/embed-options","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}