Install on WordPress

The simplest WordPress setup uses a header-and-footer code plugin. This avoids editing theme files and keeps the PopupNeko embed in place when the theme updates.

Add the script without code changes

1. Open Install Script in your PopupNeko project and copy the generated script.
2. In WordPress, install and activate the WPCode – Insert Headers and Footers plugin.
3. Open Code Snippets → Header & Footer in WordPress.
4. Paste the PopupNeko script into the Header field, then save.
5. Clear any WordPress or hosting cache and open the published site.

<script
  defer
  src="https://popupneko.com/script/popupneko.js"
  data-project-id="YOUR_PROJECT_ID"
></script>

Use the project ID from your dashboard. WordPress.com's header-code guide documents the same plugin workflow. Available code and plugin features depend on the site's WordPress.com plan; free sites restrict custom JavaScript. Self-hosted WordPress administrators can normally install a header-code plugin directly.

Add the script to the global header rather than a Custom HTML block on one page. A global installation works with PopupNeko's page targeting and avoids maintaining several copies.

Check your payment provider

Installing the script controls where popups can render. Your checkout must separately create activity that PopupNeko supports.

• Lemon Squeezy: Compatible when customers purchase through Lemon Squeezy. Its official WordPress plugin provides a product block and checkout overlay, so this is the simplest provider option for a non-technical WordPress setup. See the Lemon Squeezy WordPress guide.
• Polar: Compatible when customers purchase through Polar. Add a Polar Checkout Link as the URL of a normal WordPress Button block. Polar also offers an HTML embed when you want its checkout to open over the page. See Polar Checkout Links.
• Stripe: PopupNeko currently reads eligible paid Stripe Checkout Sessions. The standard WooCommerce Stripe extension uses checkout fields embedded in WooCommerce and should not be assumed compatible with PopupNeko's Stripe feed. A Stripe payment or charge by itself is not enough. Use PopupNeko's Real events preview to confirm your exact Stripe flow before publishing Stripe activity.

You can still use PopupNeko with WordPress when the site's ecommerce plugin is not a supported payment source. Connect a supported provider flow, or use verified Chrome Web Store reviews if that source matches your product.

Publish and verify

Open a production page and then run Verify Connection from PopupNeko. The check looks for the script URL and matching project ID in the page's returned HTML.

If verification fails, clear caches, view the page source, and confirm there is exactly one PopupNeko script. Security or optimization plugins may delay or rewrite scripts; exclude this embed from delayed loading if it disappears from the returned HTML.

Choose the paths that can display popups under Page targeting. For remaining delivery problems, follow Troubleshooting.