Install on Framer

Use Framer's site custom-code settings to load PopupNeko once across your published site. Your Framer site needs access to the custom-code feature.

Add custom code

1. Open your project's Install Script page in PopupNeko and copy the generated script.
2. Open the site in Framer and go to Project Settings → Custom Code.
3. Add a code entry for all pages and place it in the document head.
4. Choose Once for execution rather than running it on every page visit.
5. Paste the script and save the entry.

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

Use the ID from your own dashboard. The current options are described in Framer's custom-code guide.

PopupNeko handles pathname changes itself, so you do not need separate per-page embeds. Remove duplicate copies from older custom-code entries.

Publish your site

Publish the changes in Framer, then open the actual published production domain. The editor canvas is not your live installation.

If you test on a Framer preview hostname, add that exact hostname in PopupNeko's Allowed Domains. Installation verification still needs a page on your saved production domain.

Verify and choose pages

Visit your production homepage and return to PopupNeko's Install Script page. Use Verify Connection to check its HTML. A custom-code tool that inserts scripts only after JavaScript runs may not pass the HTML verifier; see script detection.

New projects target / and /pricing. Choose Specific or All under Page targeting to change that. If the script is installed but no popup appears, check live access, the project switch, and eligible source activity using Troubleshooting.