A Notion page makes a good pre-launch home: a product description, a roadmap, a changelog, all published at a notion.site address in a few clicks. The gap shows up when you want a signup form on it. Notion has no field for a script tag, so the usual advice to paste one snippet and drop in a widget div has nowhere to land.

You have two working routes. Embed a one-file page that holds the widget, or put the Notion page behind a wrapper that adds the code field Notion lacks. Each has one referral quirk worth knowing before you share the link anywhere.

Notion blocks custom scripts, so host a tiny HTML page with the OperatorStack script and <div data-os-widget="waitlist"></div>, then add it to Notion with the /embed block. If you publish through Super or Potion, paste the script into their custom code field instead and skip the extra page.

What You Need Before You Start

  • A Notion page you can edit and publish.
  • An OperatorStack account. Free to start. You need the pk_ project key from your embed snippet.
  • A place to host one HTML file (route 1 only): Cloudflare Pages, Netlify, Vercel or GitHub Pages all work.

Route 1: Embed a One-File Page

1

Create a file named index.html with only the widget on it:

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Join the waitlist</title>
  </head>
  <body style="margin:0;padding:16px;font-family:system-ui,sans-serif">
    <div data-os-widget="waitlist"></div>
    <script src="https://operatorstack.dev/os.js" data-project="pk_abc123"></script>
  </body>
</html>

Replace pk_abc123 with your project key.

2

Deploy the file to any static host. On Cloudflare Pages or Netlify, drag the folder into the dashboard and you get an HTTPS address in under a minute.

3

In Notion, type /embed on the line where the form should sit, paste the deployed address, and press Embed link. Drag the block's bottom edge until the whole form is visible, since the iframe does not resize itself.

4

Open the published notion.site address in a private window, submit a test email, and confirm the contact shows up in your OperatorStack dashboard. Use the embed verification checklist if the form stays blank.

If the block shows empty, the host is probably refusing to be framed. Look in the browser console for a message about X-Frame-Options or frame-ancestors, and remove that header from your host settings.

The referral quirk in an iframe

The script runs inside the embedded page, not on Notion. Two things follow from that.

First, ?ref=CODE on the Notion address never reaches the form. The Embed block loads one fixed URL, so a friend who clicks yourpage.notion.site/launch?ref=AB12CD lands on Notion, sees the form, and signs up with no referrer recorded.

Second, getShareLinks() builds URLs from the current origin and path, and inside the iframe that is your static host, not Notion:

OperatorStack.joinWaitlist({ email }).then((res) => {
  const links = OperatorStack.getShareLinks(res.referral_code, {
    text: "I just joined the waitlist",
  });
  // links.copy ends in https://your-static-host.pages.dev/?ref=AB12CD
});

A friend who opens that link reaches the one-file page directly, where the script reads ref and credits the referrer. So treat the static address as your referral landing page, and give your Notion page to cold traffic. If that split bothers you, use route 2.

Route 2: A Wrapper With a Code Field

Tools such as Super and Potion publish a Notion page on your own domain and add a site-wide custom code setting for the head or body. Paste the OperatorStack snippet there:

<script src="https://operatorstack.dev/os.js" data-project="pk_abc123"></script>

Then put the widget somewhere the page can render a real element. Most wrappers offer an HTML or embed option that accepts raw markup, or a code injection area where the data-os-widget div can sit. Because the script now runs on the page itself, ?ref=CODE on your domain is read directly, page views of the whole Notion site count toward your cookie-free analytics, and getShareLinks() returns links on your own domain.

The cost is the wrapper's subscription, and the exact field names vary by tool and plan, so check its docs for where site-wide custom code lives.

Which Route to Pick

Embed routeWrapper route
Extra costNoneWrapper subscription
Referral linksPoint at the embedded pagePoint at your Notion domain
Notion page views trackedNoYes
Setup timeAbout 10 minutesAbout 20 minutes

For a first validation test, the embed route is enough. Move to a wrapper when you are sending real traffic to the Notion page and want its views counted.

Common Mistakes

  • Pasting the script tag into a Notion text block. It renders as visible text and never runs.
  • Sharing the notion.site address as the referral link. Credit only works on the page where the script runs.
  • Leaving the embed block at its default height. The form clips and the thank-you state with share links is cut off.
  • Using a Notion form when you want referrals. It stores rows and nothing else.

Frequently Asked Questions

Can I paste a script tag into a Notion page?

No. Notion has no custom code field on pages or on notion.site publishes, and its Embed block takes a URL, not raw HTML. A script tag pasted as text just shows as text. You need either a separately hosted page that Notion embeds, or a wrapper such as Super or Potion that adds a custom code field in front of Notion.

Why not use a native Notion form for the waitlist?

A Notion form writes rows into a database and stops there. There is no referral code per signup, no record of which link brought each person, and no ranking of who invites friends. For a plain list of addresses it works. For a waitlist you want to grow through shares, it does not.

Why does my referral link not credit anyone when the form is embedded in Notion?

A Notion Embed block loads a fixed URL in an iframe, so a ?ref=CODE on the Notion page address never reaches the form. Share the address of the embedded page instead, where the script reads the code directly, or use a wrapper where the script runs on the page itself.

Which static host should I use for the embedded page?

Any that serves a plain HTML file over HTTPS and does not send an X-Frame-Options deny header. Cloudflare Pages, Netlify, Vercel and GitHub Pages all work with their defaults. Check the embed in a Notion preview before you publish, since a host that forbids framing shows a blank block.

Do Notion page views show up in OperatorStack analytics?

Only with a wrapper. With the iframe route, the script runs inside the embedded page, so you see views of that page and the signups it produces, not views of the surrounding Notion page. Use a wrapper's custom code field if you need the full Notion page counted.