My Dashboard

Install on an HTML website

Add PopupNeko to your shared HTML head and verify your production installation.

On this page
  1. Add the script
  2. Publish and verify
  3. If you use a template or CMS

Use this guide for a plain HTML site or a server-rendered site where you can edit the global page template.

Add the script

  1. Open Install Script in your PopupNeko project and copy its script.
  2. Edit the common HTML template used by your pages. For separate HTML files, add the script to each page where it should be available.
  3. Place it inside <head> and use your project's own ID:
index.html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Your website</title>
    <script
      defer
      src="https://popupneko.com/script/popupneko.js"
      data-project-id="YOUR_PROJECT_ID"
    ></script>
  </head>
  <body>
    <!-- Your existing page content -->
  </body>
</html>

Merge the script into your existing document; do not replace your site's content with the example. Add only one PopupNeko embed per page. The defer attribute lets the HTML finish parsing before the script runs.

Publish and verify

Publish the changed files to your production host. Visit / or another path allowed by your page targeting, then use Verify Connection on the Install Script page.

You should see Connected once the verifier detects the script and matching project ID. Popups also require live access, an enabled project, and eligible events.

If you use a template or CMS

Choose a global head/custom-code field rather than pasting the embed into visible article content. Make sure the CMS preserves the script tag and renders it in the delivered HTML. Avoid adding a second copy through a plugin or tag manager.

For staging, configure Allowed Domains. If the tag is present but no popup appears, use Troubleshooting.