Share your live 3D Globe with a public link or embed simple HTML visitor widgets on your website.
Globe Sharing via Public Link
The 3D Globe can be shared as a full-page public link that shows real-time visitor data. This is not an iframe embed - it is a standalone page that anyone with the link can view.
How to Enable Globe Sharing
Open the Globe View
Open your website's dashboard and select the Globe tab.
Click the Share Button
Click the Share button in the globe control bar.
Enable Sharing
In the share modal, click to enable globe sharing. A unique share token is automatically generated.
Copy the Link
Copy the generated public link and share it with anyone.
Share Link Format
https://app.zenovay.com/share/globe/YOUR_TOKEN
The shared globe page displays:
- Real-time visitor markers with DiceBear avatars
- Activity feed showing recent visitors
- Top stats overlay (live visitor count, plus top referrers, countries, and devices)
- Music player for ambient background audio
- Globe controls (share, music, auto-rotate, fullscreen)
Disabling Sharing
You can disable globe sharing at any time:
- Open the Globe tab and click the Share button
- Toggle sharing off
- The existing share link will immediately stop working
White-Label for Shared Pages
Enterprise PlanEnterprise customers can customize shared globe pages:
| Option | Description |
|---|---|
| Remove branding | Hides the "Powered by Zenovay" footer |
| Custom primary color | Applies your brand color to UI elements |
White-label settings are configured for your workspace in the Agency area, and they apply automatically to the shared globe page and embedded widgets.
Security
The share token provides read-only access to real-time visitor data on the globe. It cannot be used to access your dashboard, modify settings, or view detailed analytics.
- Share links are public - anyone with the link can view the globe
- Only aggregate visitor data is shown (location, page visited, time)
- No personally identifiable information is exposed
- You can revoke access by disabling sharing at any time
HTML Widget Embeds (Separate from Globe)
In addition to globe sharing, Zenovay provides simple HTML widgets that display visitor statistics. These are lightweight embeddable components - they are not 3D globe embeds.
Widget Types
| Widget | Endpoint | Description |
|---|---|---|
| Realtime | /widgets/:trackingCode/realtime | Live visitor count with pulsing indicator |
| Preview | /widgets/:trackingCode/preview | 24-hour visitor timeline chart |
| Chart | /widgets/:trackingCode/recent | 30-minute country breakdown |
Embedding a Widget
Widgets are embedded using iframes. Configure them in your domain settings under the Widgets tab, then copy the generated embed code.
<iframe
src="https://api.zenovay.com/widgets/ZV_XXXXXXXXXXX/realtime?theme=dark&primaryColor=%236366f1"
width="200"
height="120"
frameborder="0"
style="border-radius: 12px; overflow: hidden;"
></iframe>
Widget Customization
Widgets support the following parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
primaryColor | string | #e78468 | Primary accent color (hex) |
secondaryColor | string | #8dcdff | Secondary chart color, used by the Preview widget (hex) |
theme | string | system | Theme: light, dark, or system |
mainTextSize | number | 16 | Font size in pixels for the main display (10 to 32) |
hideBranding | boolean | false | Hide "Powered by Zenovay" footer (set automatically when white-label branding removal is enabled) |
Widget Settings in Dashboard
- Go to your domain settings
- Navigate to the Widgets tab
- Toggle widgets on
- Select widget type (Realtime, Preview, or Chart)
- Customize colors, theme, and text size
- Preview the widget live
- Copy the iframe embed code
Use Cases
Marketing Website
Share the live globe link to demonstrate your global reach:
- Include on your about page as an external link
- Show during client meetings and presentations
- Use fullscreen mode for office displays
Client Reporting
Share the globe with clients:
- Send the public link in reports or emails
- Enterprise white-label removes Zenovay branding for a professional look
Office Display
Show the globe on office screens:
- Open the share link in fullscreen mode
- Enable the music player for ambient background audio
- The globe updates in real-time automatically
Website Visitor Count
Embed HTML widgets on your site:
- Show live visitor count with the Realtime widget
- Display 24-hour trends with the Preview widget
- Show geographic breakdown with the Chart widget
Troubleshooting
Globe Share Link Not Working
- Verify sharing is still enabled on the Globe tab (open the Share panel)
- Re-copy the current link from the Share panel in case it changed
- Try opening the link in an incognito window to rule out browser issues
Widget Not Loading
- Confirm widgets are enabled in domain settings
- Verify the tracking code in the iframe URL matches your website
- Check for ad blockers that may block iframe content
- Ensure the widget endpoint URL is correct
Performance Tips
- HTML widgets are lightweight and load quickly
- The shared globe page requires WebGL support in the viewer's browser
- Globe performance depends on the viewer's device and browser capabilities