Browser Compatibility
This document outlines the browser compatibility for the InsightEmbed widget and provides guidance for ensuring optimal performance across different browsers and devices.
Supported Browsers
InsightEmbed is designed to work with all modern browsers. Here's a detailed compatibility list:
| Browser | Minimum Version | Notes |
|---|---|---|
| Chrome | 80+ | Full support for all features |
| Firefox | 75+ | Full support for all features |
| Safari | 13.1+ | Full support for all features |
| Edge (Chromium) | 80+ | Full support for all features |
| Opera | 67+ | Full support for all features |
| iOS Safari | 13.4+ | Limited support for screenshot capture |
| Android Chrome | 80+ | Limited support for screenshot capture |
| Samsung Internet | 12.0+ | Limited support for screenshot capture |
Feature-Specific Compatibility
Text Analysis
Text analysis features are fully supported across all modern browsers listed above.
Image Analysis
Image analysis features are fully supported across all modern browsers listed above, with the following considerations:
- File upload size limits may vary by browser
- Some mobile browsers may have limited access to device storage
Screenshot Capture
The screenshot capture functionality has specific requirements:
- HTTPS Required: Screenshot capture requires a secure context (HTTPS) in all browsers
- Browser Permissions: Users must grant screen capture permissions when prompted
- Mobile Limitations: On mobile devices, screenshot functionality may be limited by the operating system
| Browser | Screenshot Support | Notes |
|---|---|---|
| Chrome | Full | Requires user permission |
| Firefox | Full | Requires user permission |
| Safari | Partial | Limited to visible viewport on iOS |
| Edge | Full | Requires user permission |
| Opera | Full | Requires user permission |
| iOS Safari | Limited | Restricted by iOS security policies |
| Android Chrome | Limited | May vary by device and OS version |
Responsive Design
The InsightEmbed widget is designed to be fully responsive and will adapt to different screen sizes and device types:
- Desktop: Full-featured experience with optimal layout
- Tablet: Adapted layout with all features available
- Mobile: Streamlined interface optimized for touch and smaller screens
Known Issues
Internet Explorer
InsightEmbed does not support Internet Explorer (any version). Users on IE will need to switch to a modern browser.
Older Browser Versions
Browsers older than the minimum versions listed may experience:
- Rendering issues
- Performance problems
- Feature unavailability
- JavaScript errors
Browser Extensions
Certain browser extensions may interfere with the widget functionality:
- Ad blockers may block widget resources
- Privacy extensions may block API calls
- Script blockers may prevent widget initialization
Troubleshooting Browser Issues
Testing in Incognito/Private Mode
If you encounter issues with the widget, try testing in an incognito or private browsing window. This can help identify if browser extensions are causing problems.
Clearing Browser Cache
If the widget is not loading correctly or appears outdated:
- Clear your browser cache
- Refresh the page
- Try reloading the widget with
InsightEmbed.reload()
Mobile-Specific Issues
iOS Safari
- Ensure "Prevent Cross-Site Tracking" is disabled for full functionality
- For screenshot capture, users may need to use the share functionality instead
Android Chrome
- Check that camera and storage permissions are granted if using image analysis
- Some Android devices may have manufacturer-specific limitations
Fallback Strategies
For optimal user experience across all browsers, consider implementing these fallback strategies:
- Feature Detection: Use feature detection rather than browser detection
- Graceful Degradation: Provide alternative experiences when certain features aren't available
- User Guidance: Inform users when their browser doesn't support specific features
Browser Support Policy
InsightEmbed follows an evergreen browser support policy:
- We support the current and previous major versions of Chrome, Firefox, Safari, and Edge
- We update our compatibility requirements as browser technologies evolve
- We aim to provide at least 3 months' notice before dropping support for a browser version
Testing Recommendations
We recommend testing your InsightEmbed integration on:
- At least two different desktop browsers (e.g., Chrome and Firefox)
- At least one mobile browser (e.g., iOS Safari or Android Chrome)
- Both touch and non-touch devices if your audience uses both
Getting Help with Browser Issues
If you encounter browser-specific issues that aren't addressed in this guide:
- Check the Common Errors and Troubleshooting guide
- Search the community forums for similar issues
- Contact support with detailed information about the browser, device, and issue
For Pro plan subscribers, our support team can assist with browser compatibility troubleshooting and provide custom solutions for specific browser requirements.