Embed Forms

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 form The editor has four tabs: Save before copying embed code.

Setup options

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.

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).
• From your server (after product signup), call:

POST /api/v1/audience/subscribers
Authorization: Bearer av_live_…
Content-Type: application/json

{
  "embedPublicId": "<this form's public id>",
  "email": "user@example.com",
  "name": "Jane Doe",
  "marketingConsent": true,
  "sourcePath": "/signup"
}

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

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.

Related guides

• Subscribers
• Segments
• Automation
• Audience overview