Installation & SDK Setup
Audience: Developers, store administrators, or anyone setting up Reevix for the first time.
This guide covers everything you need to get Reevix running on your storefront, including the SDK snippet, domain allowlisting, signing keys, and Content Security Policy directives.
Step 1 — Get Your SDK Snippet
Navigate to Setup → Installation in your Reevix dashboard. You will see your personalised snippet — a single tag that includes your store's unique storeId.

Copy the snippet with one click and paste it into your site's before the closing tag:
<script async src="https://cdn.reevix.ai/sdk/v2/rvx.js"
data-store-id="YOUR_STORE_ID">
</script>
Once deployed, Reevix begins collecting signals immediately. No configuration required.
Step 2 — Verify the Installation
After deploying the snippet, visit your live storefront. Return to the Installation page in Reevix — within 60 seconds, the Verified badge will turn green confirming the SDK is transmitting.

If the badge does not turn green after 5 minutes:
- Confirm the
tag is present in the page source - Check your browser's Network tab for requests to
cdn.reevix.ai - Verify your domain is in the Allowed Origins list
- Check your CSP headers (see Section 4 below)
Step 3 — Add Allowed Domains
Reevix enforces a domain allowlist so your tracking ID cannot be used on unauthorized sites. Add every domain your store runs on:
https://yourstore.comhttps://www.yourstore.comhttps://staging.yourstore.com(if applicable)
You configure allowed domains in Setup → Configuration → Domains.
Step 4 — Configure Content Security Policy (CSP)
If your site uses a Content Security Policy header, add these Reevix directives:
script-src 'self' https://cdn.reevix.ai;
connect-src 'self' https://edge.reevix.ai https://api.reevix.ai;
img-src 'self' data: https://cdn.reevix.ai;
If you use a frame-ancestors directive, no changes are needed for Reevix — it does not use iframes.
Framework-Specific Guides
Shopify
Paste the snippet into your theme.liquid file, just before :
{{ '<!-- Reevix -->
<script async src="https://cdn.reevix.ai/sdk/v2/rvx.js"
data-store-id="{{ settings.reevix_store_id }}">
</script>' }}
Add reevix_store_id as a theme setting so you can update it without editing code.
Next.js (App Router)
Create a ReevixScript component and include it in your root layout:
// components/ReevixScript.tsx
import Script from 'next/script'
export default function ReevixScript() {
return (
<Script
src="https://cdn.reevix.ai/sdk/v2/rvx.js"
strategy="afterInteractive"
data-store-id={process.env.NEXT_PUBLIC_REEVIX_STORE_ID}
/>
)
}
// app/layout.tsx
import ReevixScript from '@/components/ReevixScript'
export default function RootLayout({ children }) {
return (
<html>
<body>
{children}
<ReevixScript />
</body>
</html>
)
}
React (Vite / Create React App)
// main.tsx
useEffect(() => {
const script = document.createElement('script')
script.src = 'https://cdn.reevix.ai/sdk/v2/rvx.js'
script.async = true
script.dataset.storeId = import.meta.env.VITE_REEVIX_STORE_ID
document.head.appendChild(script)
}, [])
Angular
Add to angular.json under architect.build.options.scripts:
{
"input": "https://cdn.reevix.ai/sdk/v2/rvx.js",
"inject": true,
"attributes": {
"async": true,
"data-store-id": "YOUR_STORE_ID"
}
}
Google Tag Manager
- Create a new Custom HTML tag
- Paste the snippet into the tag body
- Set trigger to All Pages
- Publish your container
Signing Keys
Signing keys are used for server-to-server events — for example, confirming a server-side purchase conversion. They are never exposed to the browser.
To rotate your signing key:
- Go to Setup → Installation → Signing Keys
- Click Rotate Key
- The new key is immediately active; the old key remains valid for 24 hours to prevent downtime
- Update your server environment variable with the new key before the overlap window closes
Never paste your signing key into frontend code. It must only live in your backend environment (e.g., .env, AWS Secrets Manager, Vault).
Server-Side Event API
Use your signing key to send trusted events from your server:
POST https://edge.reevix.ai/v1/events
Authorization: Bearer YOUR_SIGNING_KEY
Content-Type: application/json
{
"event": "purchase",
"sessionId": "rvx_abc123",
"total": 149.99,
"currency": "USD",
"orderId": "order_789"
}
This is required for reliable revenue tracking on headless storefronts or server-rendered checkouts where the browser event may not fire.