Popup Embeds

A popup embed shows your form in a modal dialog on top of your page instead of inline. It’s a good fit for any place where you want the form available but out of the way until the visitor is ready: a “Contact us” button, a feedback prompt after someone scrolls partway through an article, or a last-chance lead capture when they’re about to leave.

Configuring a popup

  1. Publish your form
  2. Go to the Share tab and click the Popup card under Embed in website
  3. Pick a Trigger in the configuration panel
  4. Adjust the trigger’s specific options, the Visibility, and the Size to taste
  5. Click Copy code and paste the snippet into your website’s HTML

The preview on the right shows a button you can click to see the popup in action, even for triggers that fire automatically on the live page.

Triggers

The Trigger option controls when the popup appears. Each trigger comes with its own set of follow-up options.

On button click

The default trigger. Renders a real <button> element on your page, and the popup opens when a visitor clicks it. Set the visible label with the Button text field. It defaults to Open form.

The button comes with no styling so you can match it to the rest of your site with your own CSS. You can also swap it for any other element (a link, a styled <div>, etc.) as long as you keep the data-fg-* attributes on it. The embed script looks for those attributes to wire up the click.

On page load

The popup appears automatically once the page loads. Use Delay (ms) to wait a number of milliseconds before showing it (for example, 2000 waits two seconds). Leave the delay empty to open the popup as soon as the page is ready.

This trigger renders a hidden trigger element rather than a button, so your visitors don’t see anything until the popup itself appears.

After scrolling

The popup appears the first time the visitor scrolls past a threshold. Set the threshold in Scroll threshold with a number and a unit:

  • % fires once the visitor has scrolled that fraction of the page (50% means halfway down).
  • px fires after that many pixels of vertical scroll.

Like the load trigger, this one is invisible until it fires.

On exit intent

The popup appears when the visitor looks like they’re about to leave the page. On desktop, that means the cursor moves toward the top of the window (heading for the back button, the tab bar, or another tab). On touch devices, where there’s no cursor to track, the popup fires when the page becomes hidden instead — for example, when the visitor switches tabs or sends the browser to the background.

Useful for a final lead capture or a “before you go” message.

Combining triggers

You can drop more than one popup snippet for the same form on the same page, each with a different trigger. For example, a click button plus an exit-intent fallback, or scroll plus exit intent. With Show only once enabled, the triggers share state, so the visitor sees the popup at most once no matter which trigger fires first.

Show only once

For any non-click trigger, Show only once stops the popup from reappearing after the visitor has seen it. The state is stored in the visitor’s browser, so it persists across tabs, refreshes, and even browser restarts. The popup will appear again if the visitor clears their browser data or comes back in a different browser or profile.

Turn this on to avoid showing the same prompt over and over to the same visitor. Click triggers don’t need this option because they only fire when the visitor actively asks for the popup.

Sizing

The Size section works the same as for standard embeds. The width and height you set become the dimensions of the modal. Auto lets the popup grow with the form’s content. Fixed keeps the modal at a specific height regardless of how short or tall the form is.

On small screens, the popup automatically fills the entire viewport, so your width and height settings only apply on larger devices.

Closing the popup

Visitors can dismiss the popup in three ways:

  • Clicking the close button in the top-right corner of the modal
  • Pressing the Esc key
  • Clicking on the dimmed area outside the modal

Keyboard and screen-reader accessibility are handled automatically: focus is trapped inside the modal while it’s open and returns to the trigger element when it closes.

Tips

  • Only one popup is open at a time on a page, so triggers fired while a popup is already showing are ignored
  • Keep delays short on the page-load trigger; popups that appear after several seconds tend to feel intrusive
  • Hidden fields populated with forwarded URL parameters work in popups too
  • The Open redirects within the embed toggle works the same in popups: by default a redirect closes the popup and navigates the parent page; turn it on to keep the redirect inside the modal