Install on Nuxt

Add PopupNeko through Nuxt's global head configuration so server-rendered and prerendered pages include the embed.

Update nuxt.config.ts

Copy your project ID from Install Script, then merge the script entry into your existing app.head.script array. Keep all other Nuxt settings and scripts.

export default defineNuxtConfig({
  app: {
    head: {
      script: [
        {
          src: "https://popupneko.com/script/popupneko.js",
          "data-project-id": "YOUR_PROJECT_ID",
          defer: true,
        },
      ],
    },
  },
});

Replace the placeholder with your dashboard's value. Nuxt documents global head configuration in its SEO and meta guide.

Keep the installation global

Do not also inject the embed in a page's useHead call or a route-change hook. One global script remains available during navigation. PopupNeko watches pathname changes and loads the appropriate activity and targeting for each route.

Hash/query-only changes are ignored. Your rules should use public URL paths such as /pricing, not Nuxt filenames.

Rebuild and verify

Rebuild and deploy the app after changing its configuration. Open a production page and run Verify Connection in PopupNeko. The embed URL and project ID must be present in the HTML returned by that page.

If you use client-only rendering or a script-management module, inspect the returned HTML: a script added only by browser JavaScript may work without passing the HTML-based verification check. See script detection.

For delivery checks, confirm live access, an enabled project, eligible activity, and matching Page targeting. Add online test hosts in Allowed Domains.