How to Embed the Visual Visitor Dashboard in a Third-Party Reporting Tool

If you use a reporting platform such as Agency Analytics, DashThis, or a custom client portal, you may want to embed the Visual Visitor dashboard as an iframe for a unified client reporting experience. This requires specific configuration to prevent CSP (Content Security Policy) blocks on iframe embedding.

Step 1 - Confirm iframe support

Contact Visual Visitor Support to confirm that iframe embedding is supported for your account and to get the correct embed URL for your white-label portal.

Step 2 - Configure the CSP on your reporting tool

If Agency Analytics or your reporting platform enforces a CSP, you will need to add the Visual Visitor portal domain as an allowed frame-src or frame-ancestors domain. Work with your reporting tool's support team to add the whitelist entry. 

Step 3 - Authentication handling

The embedded dashboard requires a logged-in Visual Visitor session. Two common approaches:

 ·       Shared view-only user:  Create a dedicated view user in Visual Visitor for the client. The client logs in once in the reporting tool context and the session is maintained.

 ·       Single Sign-On (SSO): For enterprise setups, contact Visual Visitor Support about SSO integration options.

 

Password considerations:

If the embedded dashboard shows a login prompt instead of the dashboard, the session has expired. Simplify the password for the view user to avoid encoding issues (some special characters in passwords can cause session failures in iframe contexts). 

Embedded dashboards may not support all interactive features.

Some menu navigation and export functions may not work correctly inside an iframe due to popup window blocking by the browser.

🔗 Allowing the Visual Visitor script in your CSP.

• Related Articles

• How to Allow the Visual Visitor Script in Your Content Security Policy (CSP)

  A Content Security Policy (CSP) is a browser security feature that restricts which external scripts and resources can load on your website. If your site enforces a strict CSP and the Visual Visitor domain is not whitelisted, the tracking script will ...

• How to Customize Reporting and Branding for Each Client as a Reseller

  As a Visual Visitor reseller, you can customize the reporting and branding experience for each of your clients to present a cohesive white-label product. Here is what you can customize and how. White-label branding · Logo and colors: Upload your ...

• How to Set Up a White Label Portal with Custom DNS and SSL

  Setting Up a White-Label Portal A white-label Visual Visitor portal allows your clients to access the platform using your branded domain (for example, visitors.youragency.com) instead of the Visual Visitor domain. This setup requires DNS ...

• Detection of Cookie Consent (Visual Visitor vs. Third-Party CMPs)

  Third-Party Cookie Q&A Question: How does Visual Visitor detect whether cookie consent has been provided, particularly if the consent management solution is implemented through Visual Visitor? Answer: When a visitor lands on your page, our consent ...

• How to Configure Visual Visitor with GoDaddy DNS for White Label Subdomains

  GoDaddy DNS Setup for White Label Subdomains When setting up a white-label Visual Visitor portal, your branded subdomain (for example: visitors.youragency.com) must be pointed to the Visual Visitor platform through your GoDaddy DNS settings. Follow ...