Install on Wix

Wix can load PopupNeko across the published site through its Custom Code settings. You do not need Velo or a custom Wix application.

Add PopupNeko to every page

Before starting, publish the Wix site and connect its production domain. Then:

1. Open Install Script in your PopupNeko project and copy the generated script.
2. In the Wix dashboard, open Settings.
3. Under Development & Integrations, choose Custom Code.
4. Select Add Custom Code, paste the script, and name it PopupNeko.
5. Choose All pages, load the code once per visit, and place it in Head.
6. Apply the entry and publish the site again.

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

Replace the placeholder with your dashboard's project ID. Wix documents these settings in its Custom Code guide.

PopupNeko handles distinct pathname changes during the visit, so loading one global copy avoids duplicates. Use PopupNeko Page targeting rather than creating separate Wix code entries for individual pages.

Check your payment provider

Wix's ability to accept a provider at checkout does not by itself mean PopupNeko can read that checkout. The resulting activity must match PopupNeko's supported provider records.

• Lemon Squeezy: Compatible when your Wix buttons open Lemon Squeezy checkout links or its checkout overlay. Lemon Squeezy explicitly supports adding the overlay to Wix and other website builders. See its checkout overlay guide.
• Polar: Compatible when your Wix buttons link to Polar Checkout Links. A plain checkout link is the easiest no-code option; Polar's HTML embed is also available where Wix accepts it. See Polar Checkout Links.
• Stripe: PopupNeko currently reads eligible paid Stripe Checkout Sessions from the connected Stripe account. Do not assume purchases made through Wix Stores, Wix Payments, or a Stripe provider connected inside Wix will appear. Confirm that your exact flow creates supported Checkout Sessions in the account whose restricted key you connect, then check PopupNeko's Real events preview.

If you sell through Lemon Squeezy or Polar, Wix can remain the website host while the provider owns the checkout and supplies the verified activity.

Verify the published site

Visit a production page after publishing, then use Verify Connection in PopupNeko. The verifier downloads the returned HTML and looks for the hosted script and project ID.

If Wix loads the custom-code entry only after browser JavaScript runs, PopupNeko may display while the HTML verifier reports it as undetected. Confirm the popup in a signed-out browser and follow script detection troubleshooting.

Check live access, the project switch, eligible source activity, and targeting if no popup appears. The full sequence is in Troubleshooting.