Install on Wix
Dashboard Custom Code (not the Editor) with Head placement. Paid plan required. Skip Velo HTML iframes, they run in a sandbox that cannot read window.Rekomi.
Wix has a recent UI change worth knowing about: custom code now lives in the Dashboard's Development & integrations section, not in the Editor's Settings panel. Older guides on the web still reference the Editor path, but it's gone in 2026. You also need a paid Wix plan (Light or above) since Free Wix sites cannot embed third-party scripts.
Install the head script
In the Wix Dashboard (not the Editor): Settings in the left sidebar (under Development & integrations) > Custom Code > + Add Custom Code.
In the dialog:
- Paste the head script into the Code box:
<script>
(function(){
var s=document.createElement('script');
s.src='https://js.rekomi.com/v1/rekomi.js';
s.async=true;
s.dataset.programId='YOUR_PROGRAM_ID';
document.head.appendChild(s);
})();
</script>- Name:
Rekomi - Place Code in: Head (critical — must be Head, not Body)
- Apply to: All pages
- Load code on each new page: keep on (default)
Click Save > Publish the site.
Your program ID is in Rekomi at Settings > Tracking.
Do not use Velo HTML iframe widgets
Wix exposes an HTML iframe Velo widget that you can drop into pages. Do not install Rekomi via that widget. Velo iframes run in a separate sandboxed document that cannot read or write window.Rekomi on the main page. The cookie set inside the iframe does not propagate to the main document where your CTAs live.
The Custom Code panel (Dashboard > Settings > Custom Code) injects into the main document. That's the only correct install path.
Wix Stores and Bookings
Wix's commerce stack (Wix Stores, Wix Bookings, Wix Events) can route payments through your own Stripe account via Wix Payments > Stripe, or through Wix's Merchant of Record option. The Stripe-direct path is simpler:
-
Stripe-direct (recommended): payments flow through your Stripe, which fires webhooks to Rekomi automatically. The head script captures clicks; the Stripe webhook closes the loop. No additional Wix-side step.
-
Wix MoR: payments go through Wix's merchant account. Rekomi's Stripe webhook listener won't see them. You need to fire convert from the thank-you page using Wix's per-page custom code slot (Pages > [thank-you page] > SEO & Marketing > Custom Code).
To check which mode you're on: Wix Dashboard > Settings > Accept Payments. If you see your Stripe account listed, you're on the Stripe-direct path. If you only see Wix Payments as the processor, you're on Wix MoR.
Most SaaS and SMB brands use Stripe-direct because it gives them control over the funds flow.
Quirks worth knowing
Dashboard, not Editor. The Custom Code panel was in the Editor's Settings until Wix moved it to the Dashboard. Older blog guides referencing "Site Settings > Tracking & Analytics" in the Editor are outdated.
Velo HTML iframes are sandboxed. This is a common gotcha. Velo iframes can do many things but cannot share window with the host page. Custom Code injects into the host's <head> directly, which is what Rekomi needs.
Paid plan required. Wix Free strips all custom code from published sites. Upgrade to Wix Light (the cheapest paid tier) or higher.
Apply to "All pages". If you accidentally scope the Custom Code to a specific page only, clicks on other pages won't capture. Always set "Apply to" → "All pages" for site-wide head install.
Per-page Custom Code exists for the MoR thank-you-page fire. If you're on Wix MoR for Stores/Bookings, the per-page Custom Code slot on the thank-you page is where you'd add the convert snippet. Don't confuse this with the global Dashboard install.
Refunds
Wix Stores Stripe-direct: refunds fire charge.refunded to Rekomi's Stripe webhook listener and clawback is automatic. Wix Stores MoR: subscribe to Wix's orderRefunded event from your backend (via Wix Velo or Wix's webhook API) and forward to Rekomi's /api/tracking/refund.
Troubleshooting
Custom Code menu item missing in Dashboard. You're on Wix Free. Upgrade to a paid plan.
Script saves but doesn't appear on the live site. Wix CDN caches aggressively. Hard-refresh (Cmd+Shift+R) and check View Source. If still missing, confirm you clicked Publish (not just Save) after adding the Custom Code.
Clicks register but conversions don't. You're either on Wix MoR without the per-page convert snippet, OR your Stripe webhook listener (Settings > Tracking > Stripe webhook in Rekomi) doesn't show recent events from your Wix-connected Stripe account.
Velo iframe install attempts. You probably installed via a Velo HTML element instead of Custom Code. The iframe's cookie doesn't propagate. Remove the Velo install and use Dashboard > Custom Code instead.
Related
- JavaScript pixel reference
- Install on Stripe — for Stripe-direct attribution depth
- Wix docs: Custom Code
Install on Squarespace
Code Injection greater-than Header on the Business plan or higher. Squarespace Commerce runs on your own Stripe so attribution works automatically once the head script is in place.
Install on Bubble
Settings SEO/metatags Header field for the install. Conversion fires from an HTML element on the post-signup success page using Bubble's dynamic email expression.