Kovyo installs from the Shopify App Store. The whole flow is two clicks of consent and a one-time toggle in your theme editor — no code, no copy-paste of snippets.
1. Install from the App Store
- Open the Kovyo listing on the Shopify App Store.
- Click Add app and confirm the install on your store.
- Shopify will redirect you to
app.kovyo.cowith your store already linked. The onboarding wizard runs automatically.
2. Enable the storefront app embeds
Kovyo’s popups and visitor tracker are delivered through Shopify App embeds — small theme blocks that the merchant controls in the theme editor. The wizard prompts you with a deeplink, but if you ever need to find them by hand:
- From your Shopify admin, open Online Store → Themes.
- Click Customize on your active theme.
- In the left rail, click the puzzle-piece icon labelled App embeds.
- Toggle on Kovyo Popup and Kovyo Tracker.
- Click Save in the top-right.
Both embeds run only when the page is fully loaded so they don’t affect Lighthouse scores on the storefront.
3. Verify the install
Open your storefront in an incognito tab. Within ~5 seconds of landing on any page, your active popup should fire (assuming you’ve activated one). The tracker also starts logging events silently — you can check it under Reports in the Kovyo dashboard.
If nothing fires, see the troubleshooting article.
What gets installed
| What | Where |
|---|---|
| Kovyo app permissions | OAuth token stored encrypted in our DB |
| Storefront popup runtime | Theme app embed kovyo-popup, ~6 kB gzipped |
| Visitor tracker | Theme app embed kovyo-tracker, ~3 kB gzipped |
| GDPR webhooks | Auto-registered with Shopify on install |
No theme files are modified. Uninstalling Kovyo removes both embeds
and triggers Shopify’s shop/redact webhook 48 hours later, at
which point we delete every row tied to your store.