How to add a popup to Squarespace
Squarespace ships a Promotional Pop-Up under Marketing, and for a plain newsletter box it is fine. It stops short of exit intent, multi-step forms, per-URL rules and lead delivery to anything other than Squarespace's own lists. PopupForge handles those and installs through the same Code Injection panel you may already use for analytics.
Two things trip people up on Squarespace: Code Injection is a paid feature above the Personal plan, and the menu path differs slightly between site versions and dashboard redesigns. Both are covered below, with a link to the Squarespace article that lists the exact plans.
The script tag
<script src="https://getpopupforge.com/lead-modal.js?appId=YOUR_APP_ID&configId=YOUR_CONFIG_ID" async defer></script>Replace YOUR_APP_ID and YOUR_CONFIG_ID with the values from the install panel of your published popup. The tag is the same on every platform; only where you paste it changes.
Step by step
- 01
Build and publish the popup in PopupForge
Create a free account, generate or design the popup in the visual editor, set the trigger and frequency, then publish it. The install panel shows your script tag with the appId and configId already filled in. Copy that exact tag; the placeholder version on this page will not load a popup.
- 02
Open Code Injection
In the Squarespace dashboard go to Settings > Advanced > Code Injection. On newer dashboards it lives under Website > Website Tools > Code Injection, and the search bar at the top of the settings panel finds it either way.
- 03
Paste the tag into the Footer field
Scroll to the Footer box, paste the PopupForge script tag, and click Save. Squarespace inserts footer code before the closing body tag on every page of the site, including blog posts and product pages.
- 04
Optional: a single page instead of the whole site
For a page-only install, open Pages, hover the page, click the gear, choose Advanced, and paste the tag into Page Header Code Injection. Site-wide footer injection plus PopupForge URL targeting is the lower-maintenance route.
- 05
Confirm your plan includes Code Injection
Squarespace's help article states Code Injection is available on the Core, Plus and Advanced plans (older accounts may see Business or Commerce). At the time of writing the Personal plan does not include it. If the field is greyed out, that is why.
- 06
Check Ajax loading on 7.0 templates
Some Squarespace 7.0 template families load pages with Ajax, which can stop footer scripts from re-running as visitors click between pages. If the popup only fires on the first page, disable Ajax loading in Website > Design > Site Styles or test navigation before launch. Squarespace 7.1 does not have this setting.
- 07
Test the popup and check the lead arrives
Open the live site in a private browsing window so a previous session does not suppress the popup, trigger it the way you configured (wait for the delay, scroll, or move the pointer out through the top of the window), submit a test lead, then confirm it shows in the PopupForge lead list.
Squarespace notes and gotchas
- Code Injection changes go live as soon as you save; there is no separate publish step on Squarespace.
- If you also enabled Squarespace's own Promotional Pop-Up, turn it off. Two popups competing on the same page is the fastest way to annoy a visitor.
- Squarespace's built-in cookie banner sits at a high z-index and can appear above the popup. Set the cookie banner to display first or delay the PopupForge trigger by a few seconds.
- Code Blocks inside a page also accept scripts on eligible plans, but they belong to one content block; use Code Injection for anything site-wide.
- Squarespace checkout pages do not support code injection, so the popup will not appear there.
Verify the install
Confirm the popup shows and the lead arrives
- 1.Open the site in a private window and search the page source for lead-modal.js.
- 2.Trigger the popup on the home page and on a blog post, submit a test lead.
- 3.Check the PopupForge lead list and the view and submission counts.
Official Squarespace documentation
Platform menus and plan rules change. If a step here no longer matches what you see, the official page above is the source of truth.
FAQ
Frequently asked questions
Which Squarespace plan do I need?
Code Injection is listed for the Core, Plus and Advanced plans in Squarespace's help center at the time of writing (Business and Commerce on older billing). The Personal plan does not include it. Verify against the linked Squarespace article, since plan names change.
Why use PopupForge instead of the Squarespace Promotional Pop-Up?
The built-in popup is a single-step newsletter box. PopupForge adds exit intent, scroll and delay triggers, frequency capping, up to three form steps, URL targeting, and lead delivery by CSV, email, Slack or webhook. If you only need a basic newsletter box, the built-in one may be enough.
Header or Footer injection?
Footer. The tag is async and defer, so both work, but footer placement keeps your header injection reserved for meta tags and verification snippets.
Does it work on Squarespace 7.0 and 7.1?
Yes. The only difference is the Ajax loading setting on some 7.0 templates, which can prevent scripts from re-running on internal navigation. 7.1 sites have no such setting.
Get your script tag
Generate a popup for your site, then paste one tag into Squarespace.
The free generator shows three brand-matched directions from your URL, no account needed. Creating an account gives you the visual editor, triggers, URL targeting and the install panel with your real appId and configId.