Globe Not Loading

Troubleshoot issues when the 3D globe visualization doesn't load or display correctly.

Common Globe Issues

Globe Shows Blank/Black

Cause: WebGL not supported or disabled

Check WebGL support:

1. Visit get.webgl.org
2. If you see a spinning cube, WebGL works
3. If not, your browser doesn't support WebGL

Solutions:

• Update your browser to latest version
• Enable hardware acceleration
• Update graphics drivers

"WebGL Not Supported" Error

Browser requirements:

• Chrome 56+
• Firefox 51+
• Safari 11+
• Edge 79+

Enable WebGL in Chrome:

1. Go to chrome://settings
2. Advanced → System
3. Enable "Use hardware acceleration"
4. Restart browser

Enable WebGL in Firefox:

1. Go to about:config
2. Search for webgl.disabled
3. Set to false

Globe Loads But No Markers

Causes:

1. No visitor data yet
2. The selected date range has no visits
3. Geographic data unavailable for those visits

Solutions:

1. Open the Live View tab to confirm visitors are arriving in real time
2. Widen the date range using the period selector
3. Some visits cannot be geolocated (for example, requests behind certain VPNs or proxies); these still count in your stats but may not place a marker

Globe Very Slow

Causes:

1. Integrated graphics
2. Older computer
3. Many concurrent visitors plotted at once

Solutions:

• Enable hardware acceleration in your browser (see the browser-specific sections below)
• Update your graphics drivers
• Close other GPU-intensive tabs
• For a lightweight view of the same geographic data, use the breakdowns in the Analytics tab instead

Globe Freezes Browser

Cause: GPU overload or memory issues

Solutions:

1. Close other GPU-intensive tabs
2. Reduce browser zoom level
3. Try incognito mode (no extensions)
4. Use the Analytics tab for a non-GPU view of the same data

Browser-Specific Issues

Chrome

Black screen:

• Disable conflicting extensions
• Clear GPU cache: chrome://gpu
• Reset Chrome flags: chrome://flags

Firefox

Rendering issues:

• Update Firefox
• Check about:support for WebGL info
• Try Safe Mode

Safari

Globe not appearing:

• Ensure macOS updated
• Check Safari → Preferences → Privacy
• Enable WebGL in Develop menu

Edge

Performance issues:

• Disable extensions
• Enable hardware acceleration
• Update to latest Edge

Hardware Requirements

Minimum Requirements

Component	Minimum
GPU	Intel HD 4000 or equivalent
RAM	4 GB
Browser	See above
Display	1280x720

Recommended

Component	Recommended
GPU	Dedicated graphics card
RAM	8 GB+
Browser	Latest Chrome/Firefox
Display	1920x1080+

Mobile Device Issues

Globe Not Loading on Mobile

The globe runs best on desktop. On a phone:

• Plotting many markers can be heavy on the GPU
• For a lighter experience, use the Analytics tab to see the same geographic data
• Make sure your mobile browser is up to date

Tablet Rendering Issues

• Ensure your tablet has sufficient GPU capability
• Try landscape orientation
• Keep your browser up to date

Checking GPU Status

Chrome GPU Info

1. Go to chrome://gpu
2. Check "Graphics Feature Status"
3. Look for:
   • WebGL: Hardware accelerated ✓
   • WebGL2: Hardware accelerated ✓

Firefox GPU Info

1. Go to about:support
2. Scroll to "Graphics"
3. Check WebGL renderer

Alternative Views

If globe issues persist, you can see the same geographic data without a 3D view:

Analytics Tab

1. Open your website's dashboard and select the Analytics tab
2. The countries and locations breakdown shows the same geographic data as a sortable list
3. No WebGL or GPU required, so it works on any browser

Corporate/Enterprise Environments

IT Policy Blocking WebGL

Some corporate policies disable WebGL:

• Contact IT department
• Request exception for Zenovay
• Use alternative views

VPN/Proxy Issues

VPNs may slow globe loading:

• Try without VPN temporarily
• Check for WebGL blocking proxies

Clearing Cache

If globe worked before:

1. Clear browser cache
2. Clear site data for Zenovay
3. Hard refresh (Ctrl+Shift+R)

Chrome:

1. Settings → Privacy → Clear browsing data
2. Select "Cached images and files"
3. Clear data

Firefox:

1. Settings → Privacy
2. Clear Data → Cached Web Content

Contacting Support

If issues persist, provide:

1. Browser and version
2. Operating system
3. GPU model (from chrome://gpu)
4. Screenshot of error
5. Console errors (F12 → Console)

Next Steps

• Globe Performance Optimization
• Browser Compatibility
• Alternative Visualizations