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
Navigate to the 3D Globe for your domain.
Click the Share Button
Click the Share button in the top-right 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 (visitor count, page views, bounce rate)
- Music player for ambient background audio
- Globe controls (share, music, reload, fullscreen)
Disabling Sharing
You can disable globe sharing at any time:
- Open the Globe view 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 in your domain settings and automatically apply to the shared globe page.
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 color for charts (hex) |
theme | string | system | Theme: light, dark, or system |
mainTextSize | string | 16px | Font size for the main display |
hideBranding | boolean | false | Hide "Powered by Zenovay" footer (Enterprise) |
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 in your Globe settings
- Check that the share token has not been regenerated
- 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