Browser Compatibility

Your virtual tours are designed to work seamlessly across modern browsers, so prospects and clients can explore your property anywhere. Understanding browser requirements helps you choose the best implementation for your website and ensure every visitor has a smooth experience.

What Browsers Work Best

The Visiting Media platform is optimized for current browser versions to deliver fast, reliable immersive experiences:

Browser	Minimum Version	Best Implementation
Chrome	90+	Iframe or Popup
Edge	90+	Iframe or Popup
Firefox	88+	Iframe or Popup
Safari (macOS)	14+	Popup Modal Only
Safari (iOS)	14+	Popup Modal Only

Safari requires special handling: Due to Safari's privacy settings, virtual tours must open in popup modals. Iframe implementation won't work on Safari browsers.

Implementation Options

Universal Popup Modal (Recommended)

This approach works reliably across all browsers, including Safari, and gives you the most consistent results:

 

html

<a href="#" onclick="window.open('https://truetour.app/[PROPERTY-ID]', 
   'virtualtour', 'width=1024,height=768,resizable=yes'); return false;">
   View Virtual Tour
</a>

Why we recommend popup modals:

• Works on every browser without exceptions
• No cross-origin or cookie restriction issues
• Delivers the best performance
• Provides the smoothest user experience

What to keep in mind:

• Opens in a new window or tab
• Visitors need popup blockers disabled

Adaptive Implementation (Advanced)

For developers who want browser-specific optimization, this script detects the browser and adjusts automatically:

 

javascript

function openVirtualTour() {
    const tourUrl = 'https://truetour.app/[PROPERTY-ID]';
    const isSafari = /^((?!chrome|android).)*safari/i.test(navigator.userAgent);
    
    if (isSafari) {
        window.open(tourUrl, 'virtualtour', 'width=1024,height=768,resizable=yes');
    } else {
        document.getElementById('tour-container').innerHTML = 
            `<iframe src="${tourUrl}" width="100%" height="600" frameborder="0"></iframe>`;
    }
}

Then call the function with:

 

html

<button onclick="openVirtualTour()">View Virtual Tour</button>
<div id="tour-container"></div>

Standard Iframe (Limited Compatibility)

⚠️ Important: This implementation will not work on Safari or iOS devices.

 

html

<iframe src="https://truetour.app/[PROPERTY-ID]" 
        width="100%" 
        height="600" 
        frameborder="0"
        allowfullscreen>
</iframe>

Troubleshooting Common Issues

Tour won't load:

• Third-party cookie blocking may be active—switch to popup modal implementation
• Check your browser console (F12 or Right-click → Inspect) for error messages

Blank iframe appears:

• Cross-site tracking prevention is likely enabled—use the Universal Implementation instead

"Refused to connect" error:

• CORS policy is blocking content—use popup modal implementation

Works in Chrome but not Safari:

• Browser security differences—implement the adaptive solution or universal popup modal

Mobile Device Considerations

• iOS devices: Must use popup modal implementation
• Small screens: Consider adding a viewport meta tag for optimal display
• Touch gestures: All tour navigation supports touch interactions
• Data usage: Consider warning users about potential data consumption on cellular networks

Quick Diagnostics

If your virtual tour isn't working properly, try these steps:

1. Check Browser Console (F12 or Right-click → Inspect)

• Look for red error messages
• Check for CORS or cross-origin errors
• Note any 403/404 status errors

2. Verify Implementation

• Confirm correct property ID in URL
• Ensure HTTPS is used (not HTTP)
• Check for typos in implementation code

3. Test Different Browser

• Works in Chrome but not Safari? Use popup implementation
• Doesn't work in any browser? Contact support

---

Need additional help? Contact our support team and we'll be happy to assist you.