Troubleshooting
If something is not working as expected, start here. Most issues fall into one of the categories below.
”Waiting for first event” screen is stuck
You are at the final step of the site creation wizard, you have installed the script, but the wizard keeps saying Listening for events… and never advances. After about 3 minutes, it shows you some troubleshooting tips and stops polling.
Common causes, in order of how often they cause trouble:
1. Ad blockers on your test browser
Privacy-focused extensions like uBlock Origin, AdGuard, or Brave’s built-in shields can block analytics scripts. Your own visitors may not have them, but you probably do.
Fix: open an incognito/private window (extensions are often disabled there), or test on a phone you do not use for development.
2. Script placed in <body> instead of <head>
If the script ends up inside <body> — which can happen if your CMS puts custom code in the wrong spot — some events can be missed or blocked by later scripts.
Fix: move the snippet into the <head> section, ideally right before the closing </head> tag. See Installing tracking on your site for platform-specific guidance.
3. Content Security Policy (CSP) blocking the tracking domain
If your site has a strict CSP header, it may block the tracking script from loading or from sending events. Open your browser’s developer console on your site; CSP errors are easy to spot (they usually say “Refused to load” or “Refused to connect”).
Fix: ask your developer or platform host to add the tracking hostname (for example cdn.voris.ai) to your CSP’s script-src and connect-src directives.
4. Domain mismatch
If the domain you entered in step 1 of the wizard does not match the domain you are testing from, events may be rejected.
Fix: go back to step 1, correct the domain, and retry.
5. You have not actually visited your site yet
Sounds obvious, but it happens. The wizard waits for real pageviews — it does not generate them on its own.
Fix: open your site in a new tab and load any page.
Still stuck?
If you click Resume checking and still nothing arrives, come back later when you have more time. Your tracking script and site are already created, so once the snippet is live, data will start flowing whenever you first load the page. You will see your dashboard populate automatically.
Magic link email didn’t arrive
You entered your email on the sign-in screen, clicked Send magic link, but no email shows up.
Check your spam/junk folder first
Magic link emails sometimes land there, especially on new accounts. Mark the email as “not spam” and add noreply@voris.ai to your contacts to prevent future misses.
Check the right address
Make sure you typed the email correctly. If you entered you@gmial.com instead of you@gmail.com, the link went to nobody.
Wait a minute, then try again
Delivery usually takes under 30 seconds but can occasionally take longer. The sign-in form has a built-in Resend link button with a short countdown — use it.
Corporate email filtering
Strict corporate mail filters sometimes hold messages containing login links. If you use a work address, check with your IT team or try a personal address for now.
The link expired
Magic links are single-use and expire after 10 minutes. If you click an old link, it will not work. Just request a fresh one from the sign-in page.
”Unauthorized” error even though I am an owner
You are signed in, you know you are an owner, but a page shows “You don’t have access to this resource.”
Your session might be stale
If you have been logged in for a very long time, or if your role was changed recently, your browser may be holding a stale session.
Fix:
- Sign out from the bottom of the sidebar.
- Sign back in with a new magic link.
- Try the action again.
Still getting “Unauthorized”?
If logging out and back in does not fix it, something else may be off. Contact support with:
- Your email address.
- The URL you were trying to access.
- A screenshot of the error if possible.
No data on my dashboard even though the site was created days ago
The dashboard shows:
No data yet. Install the script tag to start collecting analytics data.
Is the script actually on your site?
Open your site in a regular browser. Right-click and pick View page source. Use Ctrl+F (or Cmd+F on Mac) to search for vor.js or voris. If you do not find it, the snippet is not on your site — re-add it from Installing tracking on your site.
Is the domain right?
Go to Site settings and check the Domain field matches your actual site. If you moved your site from old-domain.com to new-domain.com, update it here.
Is an ad blocker blocking you?
Test in an incognito window or on a phone without browser extensions.
Core Web Vitals panel shows “No CWV data yet”
You need to turn on Core Web Vitals collection first. It is off by default.
- Open Site settings.
- Flip the Core Web Vitals collection toggle on.
- Save changes.
Wait a few hours for real visitors to generate data, then check the dashboard panel again. See the full Core Web Vitals guide.
Public dashboard link shows “This dashboard is not available”
Either the link has expired (tokens expire 30 days after generation) or the token has been revoked.
Fix: the site owner or admin should Regenerate token in site settings, then share the new URL.
I hit “Maximum of 10 sites” or “Maximum of 20 members”
These are per-organization limits during Phase 1b. If you need more, contact support and let us know about your use case.
Still need help?
If none of the above fits, reach out to support. Provide:
- Your email.
- The organization name.
- The site name, if the issue is site-specific.
- A description of what you did, what you expected, and what actually happened.
- A screenshot if visible in the UI.
Related
- Installing tracking on your site — where the
<script>tag goes. - Getting started — the full onboarding walkthrough.
- Site settings — all the toggles.