Subscribeam
Documentation

Embed the Subscribe Widget: Quick Start

Add a branded newsletter subscribe form to any website with a single iframe — no build step, no dependencies, no cookies.

The Subscribeam embed widget lets you drop a fully-branded subscribe form onto any website with a single <iframe>. It has no dependencies, sets no cookies, and is served from our CDN — so embedding it never slows your page down. This guide gets you from zero to a live form in a couple of minutes.

1. Create a newsletter app

Sign in, open the Embed Widget page, and create a newsletter app if you don't have one yet. Each app has its own unique widget ID (referred to below as <newsletter-id>) and its own appearance settings.

2. Customise the appearance

On the Embed Widget page, use the live configurator to set your colours, fonts, corner radius, button text and layout. The preview updates as you change settings, so you can match the widget to your site before you ship it. When it looks right, move on to the snippet.

3. Copy the embed snippet

The configurator generates a ready-to-paste snippet. It looks like this:

<iframe
  src="https://cdn.subscribeam.com/embed/<newsletter-id>.html"
  width="100%"
  height="200"
  style="border:none"
  title="Subscribe to our newsletter"
></iframe>

Paste it anywhere HTML is allowed on your site. That's the entire integration — the widget renders your subscribe form and handles the signup for you.

Why it's served from a CDN

The widget HTML is pre-rendered and served from cdn.subscribeam.com, so pages that embed it never hit our application server. That means it loads fast and stays available even under heavy traffic. The older subscribeam.com/embed/subscribe?nid=<id> URL still works too — it simply redirects to the CDN version.

Good to know

  • No cookies. The widget doesn't set cookies, so it won't complicate your consent banner.
  • Responsive. Set width="100%" and the form adapts to its container.
  • Auto-resize. The widget can report its height to the parent page via postMessage so the iframe can grow to fit its content — see Auto-resize & events.

Next steps

Using a specific platform? We have step-by-step guides for WordPress and for static sites and Ghost.