{"site":{"name":"Koji","description":"AI-native customer research platform that helps teams conduct, analyze, and synthesize customer interviews at scale.","url":"https://www.koji.so","contentTypes":["blog","documentation"],"lastUpdated":"2026-05-18T13:46:58.342Z"},"content":[{"type":"documentation","id":"c107806e-dc5c-4871-9015-10edc285b218","slug":"browser-compatibility","title":"Browser Compatibility","url":"https://www.koji.so/docs/browser-compatibility","summary":"Browser compatibility guide for Koji. Chrome and Edge are recommended. Covers text and voice interview support across browsers, embed widget requirements, technical requirements for voice (WebSocket, Web Audio API), and minimum browser versions.","content":"# Browser Compatibility\n\nKoji works in all modern browsers for text-based interviews. Voice interviews have stricter requirements due to the real-time audio technologies involved. This guide covers what works, what has limitations, and how to get the best experience.\n\n---\n\n## Quick Compatibility Table\n\n| Browser | Text Interviews | Voice Interviews | Embed Widget | Notes |\n|---|---|---|---|---|\n| Google Chrome (desktop) | Full support | Full support | Full support | Recommended browser |\n| Microsoft Edge (desktop) | Full support | Full support | Full support | Recommended for voice |\n| Mozilla Firefox (desktop) | Full support | Supported with caveats | Full support | Occasional audio echo issues |\n| Apple Safari (desktop) | Full support | Limited support | Full support | Voice may not work on older versions |\n| Google Chrome (Android) | Full support | Supported | Supported | Best mobile option |\n| Safari (iOS) | Full support | Limited support | Supported with caveats | iOS audio handling limitations |\n| Samsung Internet | Full support | Not supported | Supported | Use Chrome on Samsung devices for voice |\n| Opera | Full support | Supported | Supported | Chromium-based, similar to Chrome |\n| Brave | Full support | Supported | Supported | May need to allow WebRTC in shields settings |\n\n---\n\n## Recommended Browsers\n\n**Google Chrome** and **Microsoft Edge** are the recommended browsers for Koji. They provide:\n\n- Full support for text and voice interviews.\n- Reliable microphone access and echo cancellation.\n- Consistent WebSocket performance for real-time voice streaming.\n- Excellent developer tools for debugging embedded integrations.\n\nIf you are sharing interview links with respondents, suggesting Chrome or Edge in your invitation message helps ensure a smooth experience.\n\n---\n\n## Browser-Specific Notes\n\n### Google Chrome\n\nChrome is the most tested and best-supported browser for Koji. All features work as expected. Keep Chrome updated to the latest version for the best experience.\n\n**Tip**: If you experience microphone issues in Chrome, check that no other tab or application is using the microphone. Chrome sometimes has difficulty sharing the microphone between multiple tabs.\n\n### Microsoft Edge\n\nEdge is built on the same Chromium engine as Chrome and offers identical functionality. All Koji features, including voice, work fully in Edge.\n\n### Mozilla Firefox\n\nFirefox supports all Koji features, but voice interviews occasionally experience:\n\n- **Echo cancellation issues.** Firefox's echo cancellation is less aggressive than Chrome's. Respondents using speakers (instead of headphones) may experience echo during voice interviews.\n- **Microphone selection.** When multiple microphones are connected, Firefox may not always select the preferred one. Check Firefox's input device settings if the wrong microphone is active.\n\nFor the most reliable voice experience, we recommend Chrome or Edge over Firefox.\n\n### Apple Safari (Desktop)\n\nSafari on macOS supports text interviews fully. Voice support has improved in recent versions but still has some limitations:\n\n- **WebSocket reliability.** Safari's WebSocket implementation can be less stable than Chromium-based browsers for long-duration voice sessions.\n- **Microphone permissions.** Safari requires both browser-level and system-level microphone permissions. See [Voice Interview Not Working](/docs/voice-interview-not-working) for setup instructions.\n- **Version matters.** Safari 16+ has significantly better audio support than earlier versions. Update macOS to get the latest Safari.\n\n### Safari (iOS)\n\niOS Safari has unique audio handling that affects voice interviews:\n\n- **Audio autoplay restrictions.** iOS requires a user gesture (tap) before audio can play. Koji handles this, but it means the first interviewer response may require a tap to hear.\n- **Background behavior.** If the respondent switches to another app during a voice interview, iOS may suspend the audio session. Returning to Safari usually resumes it, but the experience can be disrupted.\n- **Microphone access.** iOS prompts for microphone permission per-site. If the respondent denied permission, they need to go to iOS Settings > Safari > Microphone to re-enable it.\n\nFor respondents on iOS, text-mode interviews generally provide a more reliable experience than voice.\n\n### Brave Browser\n\nBrave is Chromium-based and supports Koji well. However, Brave's shield settings may block WebRTC connections used for voice. If voice does not work in Brave:\n\n1. Click the Brave shield icon in the address bar.\n2. Ensure **Fingerprinting protection** is set to standard or disabled for the Koji domain.\n3. Alternatively, add koji.so to Brave's exception list.\n\n---\n\n## Embed Widget Compatibility\n\nThe embed widget works in all supported browsers with these considerations:\n\n- **iframe sandbox.** The embed widget requires that the host page does not apply overly restrictive iframe sandbox attributes. The minimum required permissions are `allow-scripts`, `allow-same-origin`, and `allow-popups`.\n- **Content Security Policy.** If the host page has a strict CSP, make sure it allows connections to `koji.so` in the `frame-src` and `connect-src` directives.\n- **Third-party cookies.** Some browsers block third-party cookies by default. The embed widget is designed to work without them, but session persistence may be affected in strict privacy modes.\n\n---\n\n## Technical Requirements for Voice\n\nVoice interviews rely on several browser APIs. If any of these are unavailable, voice mode will not work:\n\n| Technology | Purpose | Browser Support |\n|---|---|---|\n| **WebSocket** | Real-time bidirectional communication with the voice AI service | All modern browsers |\n| **Web Audio API** | Capturing and processing microphone audio | All modern browsers |\n| **MediaDevices.getUserMedia** | Requesting microphone access | All modern browsers (HTTPS required) |\n| **AudioContext** | Playing streamed audio responses | All modern browsers |\n\nIf voice fails, the most common cause is not the browser itself but rather microphone permissions or network restrictions. See [Voice Interview Not Working](/docs/voice-interview-not-working) for a full troubleshooting guide.\n\n---\n\n## Minimum Browser Versions\n\nWhile Koji targets the latest stable versions of all browsers, here are approximate minimum versions for core functionality:\n\n| Browser | Minimum for Text | Minimum for Voice |\n|---|---|---|\n| Chrome | 80+ | 90+ |\n| Edge | 80+ | 90+ |\n| Firefox | 78+ | 85+ |\n| Safari | 14+ | 16+ |\n| Chrome (Android) | 80+ | 90+ |\n| Safari (iOS) | 14+ | 16+ |\n\nWe strongly recommend keeping browsers updated to the latest version for the best experience and security.\n\n---\n\n## Troubleshooting Browser Issues\n\n### Page does not load or shows a blank screen\n\n- Clear the browser cache and cookies for koji.so.\n- Disable browser extensions one at a time to check for conflicts.\n- Try an incognito/private window.\n\n### Voice button is missing\n\n- Voice mode may not be enabled for this study. Check the study settings.\n- Try Chrome or Edge if using another browser.\n\n### Interview is slow or unresponsive\n\n- Close unused tabs to free up memory.\n- Check your internet connection speed.\n- Disable resource-heavy browser extensions (ad blockers, VPNs).\n\nFor more help, visit the [Voice Interview Experience](/docs/voice-interview-experience) or [Text Interview Experience](/docs/text-interview-experience) guides.","category":"Troubleshooting","lastModified":"2026-04-25T19:14:08.521275+00:00","metaTitle":"Browser Compatibility — Koji Docs","metaDescription":"Check which browsers support Koji features including text interviews, voice interviews, and the embed widget.","keywords":["browser compatibility","supported browsers","chrome","safari","firefox","voice browser support"],"aiSummary":"Browser compatibility guide for Koji. Chrome and Edge are recommended. Covers text and voice interview support across browsers, embed widget requirements, technical requirements for voice (WebSocket, Web Audio API), and minimum browser versions.","aiPrerequisites":["voice-interview-not-working"],"aiLearningOutcomes":["Identify the best browser for Koji","Understand voice-specific browser requirements","Configure enterprise browser settings","Troubleshoot browser-specific issues"],"aiDifficulty":"beginner","aiEstimatedTime":"6 min read"}],"pagination":{"total":1,"returned":1,"offset":0}}