[{"data":1,"prerenderedAt":430},["ShallowReactive",2],{"blog-how-to\u002Fwaitlist-notion":3},{"id":4,"title":5,"body":6,"category":400,"date":401,"dateModified":401,"description":402,"draft":403,"extension":404,"faq":405,"featured":403,"keywords":414,"meta":415,"navigation":416,"ogDescription":417,"ogTitle":5,"path":418,"readTime":419,"schemaType":420,"seo":421,"sitemap":422,"stem":423,"tags":424,"twitterCard":428,"__hash__":429},"blog\u002Fblog\u002Fhow-to\u002Fwaitlist-notion.md","Notion Waitlist: Collect Signups From a Notion Page",{"type":7,"value":8,"toc":389},"minimark",[9,13,16,31,36,63,67,97,106,117,132,146,151,154,165,172,180,187,191,194,200,218,221,225,291,294,298,324,364],[10,11,12],"p",{},"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.",[10,14,15],{},"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.",[17,18,19],"tldr",{},[10,20,21,22,26,27,30],{},"Notion blocks custom scripts, so host a tiny HTML page with the OperatorStack script and ",[23,24,25],"code",{},"\u003Cdiv data-os-widget=\"waitlist\">\u003C\u002Fdiv>",", then add it to Notion with the ",[23,28,29],{},"\u002Fembed"," block. If you publish through Super or Potion, paste the script into their custom code field instead and skip the extra page.",[32,33,35],"h2",{"id":34},"what-you-need-before-you-start","What You Need Before You Start",[37,38,39,47,57],"ul",{},[40,41,42,46],"li",{},[43,44,45],"strong",{},"A Notion page"," you can edit and publish.",[40,48,49,52,53,56],{},[43,50,51],{},"An OperatorStack account."," Free to start. You need the ",[23,54,55],{},"pk_"," project key from your embed snippet.",[40,58,59,62],{},[43,60,61],{},"A place to host one HTML file"," (route 1 only): Cloudflare Pages, Netlify, Vercel or GitHub Pages all work.",[32,64,66],{"id":65},"route-1-embed-a-one-file-page","Route 1: Embed a One-File Page",[68,69,71,80,90],"step",{"number":70},"1",[10,72,73,79],{},[43,74,75,76],{},"Create a file named ",[23,77,78],{},"index.html"," with only the widget on it:",[81,82,88],"pre",{"className":83,"code":85,"language":86,"meta":87},[84],"language-html","\u003C!doctype html>\n\u003Chtml lang=\"en\">\n  \u003Chead>\n    \u003Cmeta charset=\"utf-8\" \u002F>\n    \u003Cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1\" \u002F>\n    \u003Ctitle>Join the waitlist\u003C\u002Ftitle>\n  \u003C\u002Fhead>\n  \u003Cbody style=\"margin:0;padding:16px;font-family:system-ui,sans-serif\">\n    \u003Cdiv data-os-widget=\"waitlist\">\u003C\u002Fdiv>\n    \u003Cscript src=\"https:\u002F\u002Foperatorstack.dev\u002Fos.js\" data-project=\"pk_abc123\">\u003C\u002Fscript>\n  \u003C\u002Fbody>\n\u003C\u002Fhtml>\n","html","",[23,89,85],{"__ignoreMap":87},[10,91,92,93,96],{},"Replace ",[23,94,95],{},"pk_abc123"," with your project key.",[68,98,100],{"number":99},"2",[10,101,102,105],{},[43,103,104],{},"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.",[68,107,109],{"number":108},"3",[10,110,111,116],{},[43,112,113,114],{},"In Notion, type ",[23,115,29],{}," 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.",[68,118,120],{"number":119},"4",[10,121,122,125,126,131],{},[43,123,124],{},"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 ",[127,128,130],"a",{"href":129},"\u002Fblog\u002Fhow-to\u002Fverify-embed-script-firing","embed verification checklist"," if the form stays blank.",[133,134,135],"warning-box",{},[10,136,137,138,141,142,145],{},"If the block shows empty, the host is probably refusing to be framed. Look in the browser console for a message about ",[23,139,140],{},"X-Frame-Options"," or ",[23,143,144],{},"frame-ancestors",", and remove that header from your host settings.",[147,148,150],"h3",{"id":149},"the-referral-quirk-in-an-iframe","The referral quirk in an iframe",[10,152,153],{},"The script runs inside the embedded page, not on Notion. Two things follow from that.",[10,155,156,157,160,161,164],{},"First, ",[23,158,159],{},"?ref=CODE"," on the Notion address never reaches the form. The Embed block loads one fixed URL, so a friend who clicks ",[23,162,163],{},"yourpage.notion.site\u002Flaunch?ref=AB12CD"," lands on Notion, sees the form, and signs up with no referrer recorded.",[10,166,167,168,171],{},"Second, ",[23,169,170],{},"getShareLinks()"," builds URLs from the current origin and path, and inside the iframe that is your static host, not Notion:",[81,173,178],{"className":174,"code":176,"language":177,"meta":87},[175],"language-javascript","OperatorStack.joinWaitlist({ email }).then((res) => {\n  const links = OperatorStack.getShareLinks(res.referral_code, {\n    text: \"I just joined the waitlist\",\n  });\n  \u002F\u002F links.copy ends in https:\u002F\u002Fyour-static-host.pages.dev\u002F?ref=AB12CD\n});\n","javascript",[23,179,176],{"__ignoreMap":87},[10,181,182,183,186],{},"A friend who opens that link reaches the one-file page directly, where the script reads ",[23,184,185],{},"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.",[32,188,190],{"id":189},"route-2-a-wrapper-with-a-code-field","Route 2: A Wrapper With a Code Field",[10,192,193],{},"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:",[81,195,198],{"className":196,"code":197,"language":86,"meta":87},[84],"\u003Cscript src=\"https:\u002F\u002Foperatorstack.dev\u002Fos.js\" data-project=\"pk_abc123\">\u003C\u002Fscript>\n",[23,199,197],{"__ignoreMap":87},[10,201,202,203,206,207,209,210,214,215,217],{},"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 ",[23,204,205],{},"data-os-widget"," div can sit. Because the script now runs on the page itself, ",[23,208,159],{}," on your domain is read directly, page views of the whole Notion site count toward your ",[127,211,213],{"href":212},"\u002Fblog\u002Fhow-to\u002Fanalytics-without-cookie-banners","cookie-free analytics",", and ",[23,216,170],{}," returns links on your own domain.",[10,219,220],{},"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.",[32,222,224],{"id":223},"which-route-to-pick","Which Route to Pick",[226,227,228,243],"table",{},[229,230,231],"thead",{},[232,233,234,237,240],"tr",{},[235,236],"th",{},[235,238,239],{},"Embed route",[235,241,242],{},"Wrapper route",[244,245,246,258,269,280],"tbody",{},[232,247,248,252,255],{},[249,250,251],"td",{},"Extra cost",[249,253,254],{},"None",[249,256,257],{},"Wrapper subscription",[232,259,260,263,266],{},[249,261,262],{},"Referral links",[249,264,265],{},"Point at the embedded page",[249,267,268],{},"Point at your Notion domain",[232,270,271,274,277],{},[249,272,273],{},"Notion page views tracked",[249,275,276],{},"No",[249,278,279],{},"Yes",[232,281,282,285,288],{},[249,283,284],{},"Setup time",[249,286,287],{},"About 10 minutes",[249,289,290],{},"About 20 minutes",[10,292,293],{},"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.",[32,295,297],{"id":296},"common-mistakes","Common Mistakes",[37,299,300,306,312,318],{},[40,301,302,305],{},[43,303,304],{},"Pasting the script tag into a Notion text block."," It renders as visible text and never runs.",[40,307,308,311],{},[43,309,310],{},"Sharing the notion.site address as the referral link."," Credit only works on the page where the script runs.",[40,313,314,317],{},[43,315,316],{},"Leaving the embed block at its default height."," The form clips and the thank-you state with share links is cut off.",[40,319,320,323],{},[43,321,322],{},"Using a Notion form when you want referrals."," It stores rows and nothing else.",[325,326,327,334,340,349,358],"faq-section",{},[328,329,331],"faq-item",{"question":330},"Can I paste a script tag into a Notion page?",[10,332,333],{},"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.",[328,335,337],{"question":336},"Why not use a native Notion form for the waitlist?",[10,338,339],{},"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.",[328,341,343],{"question":342},"Why does my referral link not credit anyone when the form is embedded in Notion?",[10,344,345,346,348],{},"A Notion Embed block loads a fixed URL in an iframe, so a ",[23,347,159],{}," 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.",[328,350,352],{"question":351},"Which static host should I use for the embedded page?",[10,353,354,355,357],{},"Any that serves a plain HTML file over HTTPS and does not send an ",[23,356,140],{}," 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.",[328,359,361],{"question":360},"Do Notion page views show up in OperatorStack analytics?",[10,362,363],{},"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.",[365,366,367,368],"content-related-articles",{},"\n  ",[369,370,367,374],"contentrelatedcard",{"href":371,"title":372,"description":373},"\u002Fblog\u002Fhow-to\u002Fstatic-html-landing-page","Static HTML Landing Page: Add Analytics, Forms, and Chat with One Script Tag","The one-file page from route 1, expanded into a full landing page.",[369,375,367,379],{"href":376,"title":377,"description":378},"\u002Fblog\u002Fhow-to\u002Fwaitlist-carrd","Carrd Waitlist: Add Email Signup to Your Carrd Page","Another one-page builder where the script goes in a custom code or embed field.",[369,380,384],{"href":381,"title":382,"description":383},"\u002Fblog\u002Fhow-to\u002Fsocial-share-links-waitlist","Waitlist Share Links: Add Social Sharing to Your Thank-You Page","What to do with the referral code after signup, using getShareLinks().",[385,386],"cta-box",{"href":387,"label":388},"\u002F","Get Started Free",{"title":87,"searchDepth":390,"depth":390,"links":391},2,[392,393,397,398,399],{"id":34,"depth":390,"text":35},{"id":65,"depth":390,"text":66,"children":394},[395],{"id":149,"depth":396,"text":150},3,{"id":189,"depth":390,"text":190},{"id":223,"depth":390,"text":224},{"id":296,"depth":390,"text":297},"how-to","2026-11-12","Add a waitlist with referral tracking to a Notion page. Notion blocks custom scripts, so embed a one-file page, or use a wrapper with a code field.",false,"md",[406,407,408,410,412],{"question":330,"answer":333},{"question":336,"answer":339},{"question":342,"answer":409},"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.",{"question":351,"answer":411},"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.",{"question":360,"answer":413},"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. Put the wrapper's custom code field to use if you need the full Notion page counted.","notion waitlist,notion email signup,notion waitlist form,add waitlist to notion page,notion embed signup form,notion referral program",{},true,"Notion will not run your script tag. Two routes that work: embed a one-file page, or put the page behind a wrapper with custom code.","\u002Fblog\u002Fhow-to\u002Fwaitlist-notion","7 min","HowTo",{"title":5,"description":402},{"loc":418},"blog\u002Fhow-to\u002Fwaitlist-notion",[425,426,427],"notion","waitlist","no-code","summary_large_image","yEZb9BKTrBjGVFEw04Jup4lgK95iDYdpS_2vStWApac",1794773800732]