Skip to main content
Cool Popup runs from a single <script> tag that you add to your site’s <head> once. After that, every campaign you create and publish in the dashboard activates automatically — you never need to touch your site’s code again.

Your embed snippet

Find your unique snippet in the dashboard under Settings → Installation. It looks like this:
<script src="https://cdn.coolpopup.com/popup.js" data-id="YOUR_SITE_ID" async></script>
Replace YOUR_SITE_ID with the ID shown in your dashboard. Each site you add to Cool Popup gets its own ID.
The snippet loads asynchronously (async). It will not block your page from rendering and will not slow down your site’s load time.

Where to find your Site ID

  1. Log in to dash.coolpopup.com.
  2. Go to Settings in the left sidebar.
  3. Click Installation.
  4. Copy the full snippet — your Site ID is pre-filled.

Where to paste the snippet

Paste the snippet immediately before the closing </head> tag on every page of your site. It only needs to be added once — typically in your site’s global layout or theme file.
<head>
  <!-- your existing head content -->
  <script src="https://cdn.coolpopup.com/popup.js" data-id="YOUR_SITE_ID" async></script>
</head>

Platform-specific instructions

Open the HTML file that contains your site’s <head> section (often index.html or a shared layout template). Paste the snippet before the closing </head> tag and save the file.
<head>
  <meta charset="UTF-8" />
  <title>My Site</title>
  <script src="https://cdn.coolpopup.com/popup.js" data-id="YOUR_SITE_ID" async></script>
</head>
Upload or redeploy your file as you normally would. No other changes are required.

Verify the installation

After adding the snippet, confirm it is working correctly: Look for the Cool Popup badge. Visit your site and check for a small Cool Popup badge in the corner of the page. This badge appears by default on new installations and confirms the snippet is active. You can hide it from Settings → Installation once you have verified everything is working. Check the browser console. Open your browser’s developer tools (F12), go to the Console tab, and reload your site. If the snippet loaded correctly, you will see no Cool Popup-related errors. You may see a confirmation message such as Cool Popup initialized.
If the badge does not appear and you see errors in the console, double-check that your Site ID matches the one shown in Settings → Installation and that the snippet is inside the <head> tag, not the <body>.