Browser Compatibility

Resolve browser-specific issues with the Zenovay dashboard and tracking script.

Supported Browsers

Dashboard (app.zenovay.com)

Browser	Minimum Version	Notes
Chrome	90+	Recommended
Firefox	88+	Full support
Safari	14+	Full support
Edge	90+	Full support
Opera	76+	Full support

Tracking Script

Browser	Minimum Version	Notes
Chrome	60+	Full support
Firefox	55+	Full support
Safari	11+	Full support
Edge	79+	Full support

The tracking script is a modern JavaScript bundle and does not support Internet Explorer 11 (which Microsoft retired in 2022). Visits from IE 11 won't be recorded.

Chrome Issues

Dashboard Not Loading

Clear cache:

Press Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
Select "All time"
Check "Cached images and files"
Click "Clear data"

Disable extensions:

Open chrome://extensions
Disable all extensions
Reload dashboard
Re-enable one by one to find culprit

Common Extension Conflicts

Ad blockers: May block API calls
Privacy Badger: Can block tracking script
uBlock Origin: May need whitelist
Dark Reader: Can affect charts

Whitelist Zenovay:

*.zenovay.com

Memory Issues

If Chrome becomes slow:

Close other tabs
Clear browsing data
Disable unused extensions
Check chrome://memory-internals

Firefox Issues

WebGL Not Working (3D Globe)

Enable WebGL:

Type about:config in address bar
Search for webgl.disabled
Set to false
Restart Firefox

Check WebGL support:

Visit about:support
Look for "WebGL 1 Driver Renderer"
Should show your graphics card

Tracking Prevention

Firefox Enhanced Tracking Protection may block:

Standard mode: Usually works Strict mode: May block

Allow Zenovay:

Click shield icon in address bar
Click "Protection Settings"
Add exception for zenovay.com

If sessions not persisting:

Settings → Privacy & Security
Check "Delete cookies when Firefox closes"
Add exception for zenovay.com

Safari Issues

Intelligent Tracking Prevention (ITP)

Safari aggressively limits tracking:

7-day cookie expiry for cross-site
24-hour expiry for script-set cookies

Impact:

Returning visitors may appear as new
First-party tracking (serving the tracker from a subdomain of your own site) reduces the impact

With first-party tracking, the script loads from your own subdomain (which proxies to Zenovay) using the /script.js path:

<script
  defer
  src="https://z.yoursite.com/script.js"
  data-tracking-code="YOUR_TRACKING_CODE">
</script>

First-party tracking needs a CNAME on your domain and is available on the Scale and Enterprise plans. See First-party tracking for the full setup.

Private Relay (iCloud+)

iCloud Private Relay hides IP addresses:

Geographic data may be approximate
IP-based visitor identification affected
Cannot be bypassed

Cross-Site Tracking Blocks

If dashboard can't connect:

Safari → Settings → Privacy
Uncheck "Prevent cross-site tracking"
Or add exception for zenovay.com

WebGL in Safari

Safari WebGL limitations:

Check System Preferences → Battery
Disable "Automatic graphics switching" temporarily
Or use Chrome for 3D Globe

Edge Issues

Legacy Edge vs Chromium Edge

Chromium Edge (current): Full support Legacy Edge (pre-2020): Limited support - please update

Check version:

Settings → About Microsoft Edge
Should be version 90+

SmartScreen Blocking

If Edge blocks Zenovay:

Click "More info"
Click "Run anyway"
Or add to trusted sites

IE Mode

IE Mode in Edge is not supported:

The dashboard won't load
The tracking script won't run, so those visits aren't recorded
Use modern (Chromium) Edge mode instead

Mobile Browsers

iOS Safari

Limitations:

Same ITP restrictions as desktop
WebGL may have issues on older devices
Use Safari 14+

If app not loading:

Settings → Safari
Clear History and Website Data
Disable "Prevent Cross-Site Tracking" if needed

Chrome Mobile

Full support on:

Android 8+
Chrome 90+

If issues:

Chrome → Settings → Privacy
Check "Preload pages" is enabled
Clear browsing data

Samsung Internet

Limited testing:

Generally works
May have minor styling issues
Use Chrome for best experience

WebGL/3D Globe

Requirements

The 3D Globe requires:

WebGL 2.0 support
Hardware acceleration enabled
Adequate GPU memory

Check WebGL Support

Visit: get.webgl.org

"Your browser supports WebGL" = OK
If error, see fixes below

Enable Hardware Acceleration

Chrome:

Settings → System
Enable "Use hardware acceleration when available"
Restart browser

Firefox:

Settings → General → Performance
Uncheck "Use recommended performance settings"
Check "Use hardware acceleration when available"

Edge:

Settings → System
Enable "Use hardware acceleration when available"

If WebGL is unavailable

The 3D Globe needs WebGL, so if your browser or GPU can't run it, the Globe tab won't render. Everything else still works:

Open the Analytics tab for the same data in tables and charts (no WebGL required)
The rest of your dashboard is unaffected
Re-enable hardware acceleration (above) to bring the globe back

JavaScript Errors

Console Errors

Check browser console:

Press F12 or right-click → Inspect
Click "Console" tab
Look for red errors

Common errors:

Error	Meaning	Fix
`Script blocked`	Ad blocker	Whitelist
`CORS error`	Cross-origin issue	Check domain config
`Timeout`	Network issue	Check connection

Script Not Loading

Verify script loads:

Open Network tab (F12)
Filter by "JS"
Look for z.js from Zenovay
Check status is 200

Cookie/Storage Issues

Third-Party Cookies Blocked

Modern browsers block third-party cookies:

Solutions:

Use first-party tracking (recommended)
User grants exception
Use cookieless mode

localStorage Blocked

Private browsing blocks storage:

Sessions won't persist
This is expected behavior
Tracking still works for that session

Clear Site Data

Chrome:

F12 → Application tab
Left panel: Storage
Click "Clear site data"

Firefox:

F12 → Storage tab
Right-click → Delete All

Performance Issues

Dashboard Slow

Check:

Close other tabs
Disable extensions
Use Chrome (fastest)
Check internet speed

Reduce load:

Use smaller date ranges
Switch from the Globe tab to the Analytics tab (tables and charts are lighter than the 3D globe)

Script Affecting Site Speed

The Zenovay script is lightweight and designed to stay out of the critical render path:

Loads with defer (non-blocking)
Small payload, gzipped
Built to minimize impact on Core Web Vitals

If concerned:

<!-- Defer loading -->
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="...">
</script>

Testing Compatibility

Cross-Browser Testing

Test in your target browsers
Check major features work
Verify tracking fires

BrowserStack/LambdaTest

For comprehensive testing:

Test on real devices
Check mobile browsers
Verify tracking across browsers

Reporting Issues

If browser issue persists:

Browser details:
- Name and version
- Operating system
- Extensions installed
Issue details:
- What doesn't work
- Console errors
- Screenshots
Steps to reproduce:
- What you clicked
- What happened
- What you expected