Browser Compatibility

Koji 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.

---

Quick Compatibility Table

---

Recommended Browsers

Google Chrome and Microsoft Edge are the recommended browsers for Koji. They provide:

• Full support for text and voice interviews.
• Reliable microphone access and echo cancellation.
• Consistent WebSocket performance for real-time voice streaming.
• Excellent developer tools for debugging embedded integrations.

If you are sharing interview links with respondents, suggesting Chrome or Edge in your invitation message helps ensure a smooth experience.

---

Browser-Specific Notes

Google Chrome

Chrome 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.

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.

Microsoft Edge

Edge is built on the same Chromium engine as Chrome and offers identical functionality. All Koji features, including voice, work fully in Edge.

Mozilla Firefox

Firefox supports all Koji features, but voice interviews occasionally experience:

• 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.
• 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.

For the most reliable voice experience, we recommend Chrome or Edge over Firefox.

Apple Safari (Desktop)

Safari on macOS supports text interviews fully. Voice support has improved in recent versions but still has some limitations:

• WebSocket reliability. Safari's WebSocket implementation can be less stable than Chromium-based browsers for long-duration voice sessions.
• Microphone permissions. Safari requires both browser-level and system-level microphone permissions. See Voice Interview Not Working for setup instructions.
• Version matters. Safari 16+ has significantly better audio support than earlier versions. Update macOS to get the latest Safari.

Safari (iOS)

iOS Safari has unique audio handling that affects voice interviews:

• 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.
• 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.
• 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.

For respondents on iOS, text-mode interviews generally provide a more reliable experience than voice.

Brave Browser

Brave 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:

1. Click the Brave shield icon in the address bar.
2. Ensure Fingerprinting protection is set to standard or disabled for the Koji domain.
3. Alternatively, add koji.so to Brave's exception list.

---

Embed Widget Compatibility

The embed widget works in all supported browsers with these considerations:

• 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.
• 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.
• 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.

---

Technical Requirements for Voice

Voice interviews rely on several browser APIs. If any of these are unavailable, voice mode will not work:

If voice fails, the most common cause is not the browser itself but rather microphone permissions or network restrictions. See Voice Interview Not Working for a full troubleshooting guide.

---

Minimum Browser Versions

While Koji targets the latest stable versions of all browsers, here are approximate minimum versions for core functionality:

We strongly recommend keeping browsers updated to the latest version for the best experience and security.

---

Troubleshooting Browser Issues

Page does not load or shows a blank screen

• Clear the browser cache and cookies for koji.so.
• Disable browser extensions one at a time to check for conflicts.
• Try an incognito/private window.

Voice button is missing

• Voice mode may not be enabled for this study. Check the study settings.
• Try Chrome or Edge if using another browser.

Interview is slow or unresponsive

• Close unused tabs to free up memory.
• Check your internet connection speed.
• Disable resource-heavy browser extensions (ad blockers, VPNs).

For more help, visit the Voice Interview Experience or Text Interview Experience guides.