Klaviyo embed forms. In the page, not over it.

An embedded form sits inside your page, most often in the footer, and waits for the visitor to come to it. It never covers anything, so it is the signup almost every store should have, whatever else it runs. This guide covers creating an embed form in Klaviyo, finding its form ID and code, placing it on Shopify and other sites, styling it, posting your own HTML form to Klaviyo instead, fixing one that does not appear and what double opt-in changes. For popups, flyouts and the wider form setup, start with the Klaviyo signup forms guide.

By the numbers

Vendor figures are averages across many stores, not controlled tests. Use them to decide what to test first.

What an embedded form is

Klaviyo builds five form types: popup, flyout, full page, banner and embed. The first four float over or around the page. An embed form appears exactly where you put its code, such as the footer, a blog post or a landing page, and stays there. Klaviyo calls it the least intrusive type, and it has no close icon because there is nothing to close. The trade-off is reach: Klaviyo says popups have the highest conversion rate of any form type, while an embed only collects from people who scroll to it. That is why Klaviyo recommends a footer embed alongside your other forms, not instead of them.

Before you build: turn on sign-up forms

Every Klaviyo form, embedded or not, is drawn by Klaviyo.js, the onsite tracking script. Klaviyo's term for this is enabling sign-up form functionality. On Shopify, the script comes from the Klaviyo app embed in your theme. Check it in Klaviyo's Shopify integration settings under Onsite Tracking: a green banner reading "The Klaviyo app embed is enabled on your Shopify store" means you are ready, and a yellow "Klaviyo app embed is turned off" means you are not. App embeds belong to a theme, so if you publish a new theme, turn the embed on there too. Your theme must also support app blocks; Klaviyo's example uses a Shopify 2.0 theme.

Create the embed form in Klaviyo

Open Sign-up forms and select Create form. If a channel selector appears, name the form and choose Web. In the library, open Form style and choose Embed to see embed templates, or select Create blank form and set the type to Embed. Confirm the name and pick the list each channel submits to; a separate embed form can feed a different list, for example a blog newsletter. Then design it in the editor. For a footer, Klaviyo recommends asking for an email address only, which raises opt-ins. Save the phone number for a popup or a second step elsewhere.

Publish it and copy the embed code

Resolve any blocking alerts, choose Publish or schedule, then Publish now, and confirm. A "Your form is published!" window offers the code: select Copy. If the window does not appear, or you need the code later, open Targeting & behavior, then Display, and copy the snippet under Embed code. It is a single div: in <div class="klaviyo-form-ABC123"></div>, the form ID is ABC123. Klaviyo.js, which must be running on the page, draws the form there. Popups, flyouts and full-page forms need no code at all; only embeds do. Note that the editor's preview of an embed only works on a page that already contains the form's code.

Find the embedded form ID

The form ID is the short code Klaviyo generates for each form, such as ABC123 or Y6nRLr. Klaviyo's documented place to find it is the embed code: in <div class="klaviyo-form-ABC123"></div>, everything after klaviyo-form- is the ID. Copy the code from Targeting & behavior, then Display, Embed code. The same code also appears in the address bar while you edit the form, after /forms/, though Klaviyo's help pages do not document that. Developers can list every form and its ID with Klaviyo's Get Forms API endpoint, which needs the forms:read scope. You need the ID, not the whole snippet, for the Shopify app block. Every form has one, but only embed forms need it placed on a page.

The form action URL and custom HTML forms

Older tutorials show a hand-written HTML form whose action URL posts to a Klaviyo address such as manage.kmail-lists.com/ajax/subscriptions/subscribe, or to Klaviyo's v1 and v2 list subscribe API. Klaviyo retired its v1 and v2 APIs on June 30, 2024. The kmail-lists endpoint is undocumented, so do not build on it. If you need your own markup rather than a Klaviyo form, the supported route is Klaviyo's Create Client Subscription endpoint: a POST from the browser to a.klaviyo.com/client/subscriptions with your public API key (site ID) as company_id, a revision header, the email or phone and the list. It allows 350 requests a second and 750 a minute. Klaviyo says to call it only from the browser and never with a private API key. The list's own opt-in setting still applies, so on a double opt-in list the subscriber gets Klaviyo's confirmation email. If you have restricted your public key to an allowlist of domains, add your site, or forms will display but not submit.

Add it to Shopify with the app block

In Shopify, go to Online Store, then Themes, and click Edit theme on the published theme. Pick the page template from the top menu, for example Home page or Password page. In the left menu choose Add section, then Apps, then Klaviyo Embedded Form, and place it in either a template section, where it shows on every page using that template, or the Footer section, where it shows across the site. Click the new Klaviyo Embedded Form section, paste only the form ID (ABC123, not the whole div), and click Save. The form does not appear in the theme preview until you save. To show it on one page only, create a separate template and assign it to that page. Shopify's thank you and order status pages do not support embed forms natively.

Custom Liquid, other platforms and tag managers

Klaviyo's Shopify guide covers the app block only, not a Custom Liquid section. Elsewhere, Klaviyo's instruction is to paste the full embed snippet into the page's HTML wherever the form should go, with Klaviyo.js loaded. On BigCommerce and WooCommerce that means your site's files or HTML; on Square Online, an Embed code section in the site editor. On a custom site you need two snippets: Klaviyo.js, which Wix, PrestaShop and Magento 1 and 2 add automatically once integrated, and the form's embed code. If a tag manager such as Google Tag Manager delivers Klaviyo.js, the builder may warn "Unable to detect installation"; Klaviyo says that warning does not stop you publishing. Save your site changes, then refresh the live page.

Style it to match the store

Style an embed in Klaviyo's editor rather than in your theme. An embed with a side image defaults to 780 px wide with a Medium image; change the width and minimum height in Embed settings, and the image's share under Styles. Side images are hidden on mobile unless you choose All devices. Background color, border and padding live in Styles; margin is not available for embeds, so leave spacing to the theme section around it. Fonts can be Klaviyo's web-safe set, Klaviyo-hosted fonts or your own uploads. Klaviyo recommends background images 600 to 1000 px wide and under 200 KB, with a 5 MB upload limit. Paid accounts can add custom CSS and HTML, which Klaviyo does not support. If the form looks different on the live site, your theme's CSS is probably overriding it; Klaviyo suggests removing !important rules where you can.

Why the embed form isn't showing up

Check in order. Is the form Live in the Status column, not Editing? Is Klaviyo.js running: on Shopify, is the app embed on in the published theme? Did you save the page or theme after adding the code? Does the pasted div, or the form ID in the app block, match the form exactly? Under Targeting & behavior, does your device match Display, and do you meet the Audience, URL, UTM, location and, on Shopify, cart rules? Only one Klaviyo account should supply Klaviyo.js; turn off "Automatically add Klaviyo onsite JavaScript" in any other. Then test in a private window with extensions off and the cache cleared. Ad blockers strip third-party scripts, and GWI puts their use at 29.5% of internet users. If you target by audience, a private window is an unidentified visitor, so the form may correctly stay hidden. In the EU, EEA, UK and Switzerland, Shopify's cookie consent can block Klaviyo's onsite tracking until the visitor accepts. Custom CSS from your theme or the form can hide it. Klaviyo forms do not render in Internet Explorer, and single page apps can show them intermittently.

Double opt-in and the success message

The embed submits to a list, and the list decides what happens next. On a double opt-in list, Klaviyo emails a confirmation and adds the person only after they click it; a profile can exist before then, but it is not on the list and the welcome series waits. On single opt-in, the submitter joins at once. New email lists take your account's default opt-in setting, and changing that default does not touch existing lists. To change a list, go to Audience, Lists & segments, open the list, then Settings, Consent, and choose under Opt-in process. Write the success step to match: "Check your inbox to confirm" for double opt-in, "You're on the list" for single.

Measure it differently from a popup

Submit rate is submitted form events divided by viewed form events. Since December 6, 2024, Klaviyo counts an embed view only when the form is in the visitor's viewport, which changed view counts and submit rates for footer forms in particular. Since April 1, 2025, Klaviyo also filters bot and crawler views, so older numbers may not compare. Klaviyo shows benchmark status only for popups and has no benchmarks for embed forms, so judge a footer form against its own history: submissions per week and the share of new subscribers it brings in. Its 3% general benchmark and popup averages such as Wisepops' 4.82% describe forms that interrupt, not forms that wait.

Embedded or popup: which, when

Use an embed where the visitor is already reading and intent is plain: the footer, the end of a blog post, a dedicated signup or launch page, or a password page before a drop. Use a popup, flyout or full-page form for the first-visit welcome offer, an exit-intent last chance or a campaign, where you need to reach people who will never scroll to the footer. Most stores run both: one footer embed site-wide, asking for email only, plus one popup with the offer. Keep the two on the same list, or on lists your flows treat the same way, so a footer subscriber gets the same welcome as a popup subscriber.

Where Veya fits

Veya does not build embedded forms. Inline embeds are on its roadmap and not built, so keep your Klaviyo embed in the footer. Veya builds the other half: custom popups designed for your store from a brief, which connect to Klaviyo by OAuth and send each form's consented signups to the Klaviyo list you choose for that form, with profile properties and a Veya Signup event your flows can start from. The list's own opt-in setting still applies. A "Known to Klaviyo in this browser" rule keeps the popup from people Klaviyo already knows, and visitors who signed up through Veya never see a signup form again. Turn on the Veya forms app embed in your theme, and pause any Klaviyo popup on the same pages so a visitor meets one invitation, not two.

Questions

How do I get the embed code for a Klaviyo form?

Publish the form, then select Copy in the "Your form is published!" window. If you missed it, open the form, go to Targeting & behavior, then Display, and copy the snippet under Embed code. It looks like <div class="klaviyo-form-ABC123"></div>, where ABC123 is the form ID. Only embed forms have embed code; popups, flyouts and full-page forms publish without any.

How do I add a Klaviyo embedded form to Shopify?

Make sure the Klaviyo app embed is on in your published theme. Then in the theme editor choose Add section, Apps, Klaviyo Embedded Form, in a template or the footer. Paste only the form ID from the embed code into the block's textbox and click Save. The form shows after you save, not in the unsaved preview.

Why is my Klaviyo embed form not showing?

Usually one of five things: the form is not Live, Klaviyo.js is not running (on Shopify, the app embed is off in the live theme), the page or theme was not saved after adding the code, the div or form ID does not match, or targeting excludes you. Retest in a private window with ad blockers off, since blockers can stop Klaviyo.js loading.

Can I add a Klaviyo embed form to the footer?

Yes, and Klaviyo calls a footer embed a best practice for list growth. On Shopify, add the Klaviyo Embedded Form block to the Footer section; elsewhere, paste the embed code into your footer's HTML. Klaviyo recommends asking for an email address only in a footer form, which improves opt-ins.

Can I style a Klaviyo embedded form with CSS?

Style it in Klaviyo's editor first: width and minimum height in Embed settings, background, border, padding and fonts in Styles. Paid Klaviyo accounts can add custom CSS and HTML, though Klaviyo does not support custom code. If the live form looks wrong, your site's CSS is likely overriding it, and removing !important rules often fixes it.

Do Klaviyo embedded forms use double opt-in?

They follow the opt-in setting of the list they submit to. On a double opt-in list, the subscriber gets a confirmation email and joins only after clicking it; on a single opt-in list they join at once. New lists use your account default, and you change a list under Settings, Consent, Opt-in process.

Where do I find my Klaviyo embedded form ID?

In the form's embed code, under Targeting & behavior, then Display, Embed code. In <div class="klaviyo-form-ABC123"></div>, the form ID is ABC123. On Shopify you paste only that ID into the Klaviyo Embedded Form app block.

What is the Klaviyo form action URL?

Hand-written HTML forms used to post to an undocumented Klaviyo address or to the v1 and v2 subscribe APIs, which Klaviyo retired on June 30, 2024. Today, post a custom form from the browser to Klaviyo's Create Client Subscription endpoint, a.klaviyo.com/client/subscriptions, with your public API key as company_id and the list ID, or use a Klaviyo embed form instead.

Sources

Figures checked November 16, 2026.

Your next popup?
We’ll build it for you.

14-day free trial on every plan. Custom design and revisions included.