# Browser compatibility

## General

In order for Authereum to function properly without any issues, do the following:

* Do not use ad blockers on Authereum enabled sites (often labeled under *shields*)
* Enable cross-site storage in browser settings (often labeled under *cookies* or *trackers*)

### Browser Test

You can visit the [browser test ](https://browser-test.authereum.com)page to see if your browser or browser settings is compatible with Authereum:

[https://browser-test.authereum.com](https://browser-test.authereum.com/)

![](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M2Ap3QtBr-ZI04zX06x%2F-M2AuZUiN3tpRLL_eh_E%2Fsafari_48x48.png?alt=media\&token=faa0346d-efc9-4ebe-b302-2af667a44423)

## Safari (desktop)

#### Version supported: 13+

Browser supported: [✔️](https://emojipedia.org/check-mark/) (requires cross-site storage enabled)

Private window supported: [❌](https://emojipedia.org/cross-mark/)

#### Requirements:

* Cross-site storage
* Disabled pop-up blocker

Safari by default disables cross-site storage reading. Authereum requires cross-site storage reading to read sandboxed signing keys that live in the browser local storage.

Safari disallows cross-site storage in private mode so it won't be possible to use Authereum on Safari Private window mode.

#### To enable cross-site storage follow these steps:

*Safari* → *Preferences* → *Privacy* → Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Prevent cross-site tracking**

![Uncheck "Prevent cross-site tracking" setting](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M29se04Ltqs6KWf1Lgt%2F-M2Aeumh_Xzt-ASZNFS0%2Fsafari_enable_cross-site_storage.png?alt=media\&token=109a9724-9109-435b-8f19-6e70a9c41aff)

#### To enable pop-ups follow these steps:

*Safari* → *Preferences* → *Websites* → **Allow**

![Change dropdown setting to "Allow" for the website](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M29se04Ltqs6KWf1Lgt%2F-M2AeumgOgR0Pg77ot6a%2Fsafari_enable_popups.png?alt=media\&token=518fe94f-28f2-4cd2-be53-122051740a21)

## Safari (iOS)

#### Version supported: 13+

Browser supported: [✔️](https://emojipedia.org/check-mark/)  (requires cross-site storage enabled)

Private window supported: [✔️](https://emojipedia.org/check-mark/)  (requires cross-site storage enabled)

#### Requirements:

* See [Safari (desktop) ⬆️](#safari-desktop): 

#### To enable cross-site storage follow these steps:

*Settings* → *Safari* → *Privacy & Security* → Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Prevent Cross-Site Tracking**

![Toggle off "Prevent Cross-Site Tracking" switch](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M2ZIeOMxrAw1e02Rm6Y%2F-M2ZJbHgWcboJdWUW9gH%2Fsafari_ios_enable_cross-site_storage.png?alt=media\&token=959364fd-2fb5-4caf-b59e-87a56ec956c1)

#### To enable pop-ups follow these steps:

*Settings* → *Safari* → *General* → Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Block Pop-ups**

![Toggle off "Block Pop-ups" switch](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M2ZIeOMxrAw1e02Rm6Y%2F-M2ZJsxUXf25PQoWULTz%2Fsafari_ios_enable_popups.png?alt=media\&token=cce9b9f0-94a5-475c-97df-e7e548811eac)

![](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M2Ap3QtBr-ZI04zX06x%2F-M2AuZUhJgy5pIaAFo_F%2Fchrome_48x48.png?alt=media\&token=bf8885ca-4657-403e-ad7d-cd12ea96dab6)

## Chrome (desktop)

#### Version supported: 80+

Browser supported: [✔️](https://emojipedia.org/check-mark/)

Incognito window supported (version 83 or under): [✔️](https://emojipedia.org/check-mark/)

Incognito window supported (version 84+): [❌](https://emojipedia.org/cross-mark/) (requires cross-site storage enabled)

#### Requirements:

* Cross-site storage
* Disabled pop-up blocker

**To enable cross-site storage in Incognito follow these steps (for versions 84+):**

*New tab* → *Block third-party cookies* → Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Block third-party cookies**

![](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-MDbJI4_Vfy_sAXsMWUe%2F-MDbRHUe1u1Al5p5ugpX%2Fchrome-incognito-allow-third-party-cookies.png?alt=media\&token=9e1dfaad-d9af-4f50-acc7-794e7cffcd4a)

**To enable cross-site storage follow these steps (for versions 84+):**

*Menu* → *Settings* → *Privacy and Security* → *Site Settings* → *Cookies and site data* → *General settings* → Check [✔️](https://emojipedia.org/check-mark/) **Allow all cookies**

![](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-MDbJI4_Vfy_sAXsMWUe%2F-MDbSZ3_Pvj7eDMPNFlz%2Fchrome-allow-third-party-cookies.png?alt=media\&token=e6a98216-f76a-4a81-b1e7-00cc8d8753a2)

**To enable cross-site storage follow these steps (for versions 83 or under):**

*Menu* → *Settings* → *Privacy and Security* → *Site Settings* → *Cookies and site data* → Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Block third-party cookies**

![Uncheck "Block third-party cookies" setting](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M29se04Ltqs6KWf1Lgt%2F-M2AeumdFnzF0Dv9GFZG%2Fchrome_enable_third_party_storage.png?alt=media\&token=605dd66e-a8df-41c3-969a-677f32df8272)

#### To enable pop-ups follow these steps:

*Menu* → *Settings* → *Privacy and Security* → *Site Settings* → *Pop-ups and redirects* → Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Blocked (recommended)**

![Uncheck "Blocked (recommended)" setting](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M29se04Ltqs6KWf1Lgt%2F-M2AeumfBr9AwescYw5J%2Fchrome_enable_popups.png?alt=media\&token=cb2d922c-42fb-4d10-a7e2-f69bec7c3861)

![](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M2Ap3QtBr-ZI04zX06x%2F-M2AuZUf4HHDsY5szn5D%2Ffirefox_48x48.png?alt=media\&token=ffdab3ef-374a-4b8b-859d-e21a6e12d6f6)

## Firefox (desktop)

#### Version supported: 74+

Browser supported: [✔️](https://emojipedia.org/check-mark/)

Private window supported: [❌](https://emojipedia.org/cross-mark/)

#### Requirements:

* Disabled pop-up blocker

#### To enable pop-ups follow these steps:

*Menu* → *Preferences* → *Privacy & Security* → Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Block pop-up windows**

![Uncheck "Block pop-up windows" setting](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M29se04Ltqs6KWf1Lgt%2F-M2AeumVbGyyMnWH5aR6%2Ffirefox_enable_popups.png?alt=media\&token=470dd902-3af0-40aa-82cc-40341b77afab)

![](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M2Ap3QtBr-ZI04zX06x%2F-M2AuZUkDT-WUNZiMPmp%2Fopera_48x48.png?alt=media\&token=7e6ea544-f827-4814-96b1-1aa64442dc30)

## Opera (desktop)

#### Version supported: 67+

Browser supported: [✔️](https://emojipedia.org/check-mark/)

Private window supported: [✔️](https://emojipedia.org/check-mark/)

#### Requirements:

* See [Chrome ⬆️](#chrome-desktop): 

![](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M2Ap3QtBr-ZI04zX06x%2F-M2AuZUSbxSS4_Z4SyiV%2Fedge_48x48.png?alt=media\&token=4c4e3afa-55c5-44b1-a892-eadf11c3efd7)

## Microsoft Edge (desktop)

#### Version supported: 80+

Browser supported: [✔️](https://emojipedia.org/check-mark/)

InPrivate window supported: [✔️](https://emojipedia.org/check-mark/)

#### Requirements:

* See [Chrome ⬆️](#chrome-desktop): 

![](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M2Avn1XsdMo7D7-n6vl%2F-M2AvsPM0CXX0sNs2b-P%2Fbrave_48x48.png?alt=media\&token=eb67243b-4a68-4923-a756-d19be16a95db)

## Brave (desktop)

#### Version supported: 80+

Browser supported: [✔️](https://emojipedia.org/check-mark/)  (requires cross-site storage enabled)

Incognito window supported: [✔️](https://emojipedia.org/check-mark/)  (requires cross-site storage enabled)

#### Requirements:

* Disable Shield and allow third party cookies
* See [Chrome ⬆️](#chrome-desktop) for more requirements: 

**To enable cross-site storage follow these steps:**

*Shield* →  Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Cross-site trackers blocked**

*Shield* →  Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) **Scripts blocked**

*Shield* →  *scripts blocked* →  Select **All cookies allowed**

![Uncheck "Cross-site trackers blocked" and select "Allow cookies Allowed"](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M3rdlRgRYcCn2SGRhEi%2F-M3rdr8I3k57VpJVwjLs%2Fbrave_allow_cookies_in_shield.png?alt=media\&token=1eabec26-ee3d-48ac-a825-ed0c3cc9d046)

#### To completely disable shield follow these steps:

*Shield* → *If a site appears broke, try shields dow*n → Uncheck [⭕](https://emojiterra.com/heavy-large-circle/) *Shields UP for this site* so that it says **Shields DOWN for this site**

![Uncheck shield switch to completely disable shield](https://3551326670-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtqfI5R9O0jZ6EUSMby%2F-M3rdlRgRYcCn2SGRhEi%2F-M3rdu8tXCC3sSygsoXx%2Fbrave_disable_shield.png?alt=media\&token=e6d3e74b-984e-4755-b8c6-6efd194f7a00)

## Other browsers

If you encounter any browser issues, please let us know:

{% content-ref url="bug-reports" %}
[bug-reports](https://docs.authereum.com/bug-reports)
{% endcontent-ref %}