Audience → Embed forms builds standalone signup widgets. Pick a site list and optional segment, style the form, then copy a script snippet or iframe for any external website.
What embed forms are
Embed forms collect subscribers outside your Aveiro-built pages — on WordPress, Webflow, a landing page on another host, or your own app.Each form:
Adds contacts to a chosen site list in Audience
Optionally tags them with a segment
Matches your brand via theme tokens and layout options
Create a form
Audience → Embed forms → New embed formThe editor has four tabs:
Colors, border, surface, scaling — same token model as Aveiro sites
Embed code
Preview, copy script snippet or iframe URL
Save before copying embed code.
Setup options
Field
Purpose
Form name
Internal label in Aveiro
List (site)
Which site's subscriber list receives signups
Segment
Optional auto-tag on subscribe
Allowed origins
Optional — one URL per line (e.g. https://example.com or *.example.com). Empty allows any origin for API calls.
Restricting origins improves security when you know exactly which pages host the form.
Content options
Heading and description above the fields
Button label and success message after submit
Ask for name — optional name field
Marketing consent checkbox — with custom consent label text
Always align consent copy with your privacy policy and local regulations.
Appearance
Theme tab controls Once UI tokens: theme mode, neutral palette, brand/accent colors, border style, solid style, surface, and scaling.
Appearance (size, layout, alignment, compact mode) mirrors the Email Signup component in the site editor:
Size — form scale
Layout — column or row field arrangement
Alignment — left, center, or right
Compact — inline submit icon inside the email field
When using the script loader, host-page data-* attributes can override saved appearance settings.
Two host-page options exist only as overrides, for fitting the form into a page you already designed:
Transparent background — data-background="transparent" (iframe: ?background=transparent). The form drops its own page colour and most of its padding, and sits directly on your page. Pass a matching data-theme so field text is drawn for your page's light or dark mode. A 4px inset stays so focus rings are not cut off at the frame edge.
Subscriber count — data-subscriber-count="true" (iframe: ?subscriberCount=true). Shows the verified "Join N subscribers" line, counted from active subscribers. It stays hidden until the list passes the form's minimum, so a new list never advertises a handful of readers.
Embed code
After save, the Embed code tab provides:
Live preview of the form
Script snippet — paste before </body> on external pages
Iframe URL alternative for strict CSP environments
Click Copy snippet to clipboard.
Subscribe from your product (API)
Use the API tab in the embed form editor for copy-paste examples. This is the right path when someone signs up to your product and you want them on your Aveiro list automatically — no iframe required.
Create an API token with the audience:write scope (Organization → API tokens).
The embedPublicId resolves the site list and default segment from this form. You can override segment in the body if needed.
For browser-side fetch from another origin (custom form UI), use POST /api/email/subscribe with the same embedPublicId and set Allowed origins on the form.
vs Email Signup on Aveiro sites
Embed form
Email Signup component
Where
Any external website
Pages built in the Aveiro editor
Setup
Audience → Embed forms
Editor → add component to page
Styling
Per-form theme tab
Block styles + site theme
List / segment
Form setup
Component settings
Both feed the same Audience subscriber list.
Editing and deleting
From the embed forms list, click Edit to change setup, content, or theme. Updates apply to the same public form ID — no need to replace the snippet unless you create a new form.
