diff --git a/docs/desktop-browsers.md b/docs/desktop-browsers.md
index 74b84145..86c1b5e7 100644
--- a/docs/desktop-browsers.md
+++ b/docs/desktop-browsers.md
@@ -294,8 +294,8 @@ Brave allows you to select additional content filters within the internal `brave
-1. This option provides functionality similar to uBlock Origin's advanced [blocking modes](https://github.com/gorhill/uBlock/wiki/Blocking-mode).
-2. If you wish to stay logged in to a particular site you visit often, you can set exceptions on a per-site basis by clicking on the Shield icon in the address bar.
+1. This option disables JavaScript, which will break a lot of sites. To unbreak them, you can set exceptions on a per-site basis by clicking on the Shield icon in the address bar and unchecking this setting under *Advanced controls*.
+2. If you wish to stay logged in to a particular site you visit often, you can set exceptions on a per-site basis by clicking on the Shield icon in the address bar and unchecking this setting under *Advanced controls*.
#### Privacy and security
@@ -303,7 +303,7 @@ Brave allows you to select additional content filters within the internal `brave
- [x] Select **Don't allow sites to use the V8 optimizer** under *Security* → *Manage V8 security* (1)
- [x] Select **Automatically remove permissions from unused sites** under *Sites and Shields Settings*
-- [x] Select **Disable non-proxied UDP** under [WebRTC IP Handling Policy](https://support.brave.com/hc/articles/360017989132-How-do-I-change-my-Privacy-Settings#webrtc)
+- [x] Select **Disable non-proxied UDP** under [*WebRTC IP Handling Policy*](https://support.brave.com/hc/articles/360017989132-How-do-I-change-my-Privacy-Settings#webrtc)
- [ ] Uncheck **Use Google services for push messaging**
- [x] Select **Auto-redirect AMP pages**
- [x] Select **Auto-redirect tracking URLs**
@@ -338,7 +338,6 @@ Brave's Web3 features can potentially add to your browser fingerprint and attack
- Select **Extensions (no fallback)** under *Default Ethereum wallet*
- Select **Extensions (no fallback)** under *Default Solana wallet*
-- Set *Method to resolve IPFS resources* to **Disabled**
#### Extensions
@@ -364,8 +363,6 @@ Brave's Web3 features can potentially add to your browser fingerprint and attack
**Brave Wallet** operates locally on your computer, but does not support any private cryptocurrencies, so we would discourage using this feature as well.
-## Additional Resources
-
## Criteria
**Please note we are not affiliated with any of the projects we recommend.** In addition to [our standard criteria](about/criteria.md), we have developed a clear set of requirements to allow us to provide objective recommendations. We suggest you familiarize yourself with this list before choosing to use a project, and conduct your own research to ensure it's the right choice for you.
diff --git a/docs/mobile-browsers.md b/docs/mobile-browsers.md
index 8752b0b6..52b13d4e 100644
--- a/docs/mobile-browsers.md
+++ b/docs/mobile-browsers.md
@@ -63,8 +63,8 @@ Brave is built upon the Chromium web browser project, so it should feel familiar
Downloads
- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=com.brave.browser)
-- [:simple-github: GitHub](https://github.com/brave/brave-browser/releases)
- [:simple-appstore: App Store](https://apps.apple.com/app/id1052879175)
+- [:simple-github: GitHub](https://github.com/brave/brave-browser/releases)
@@ -74,70 +74,110 @@ Brave is built upon the Chromium web browser project, so it should feel familiar
Tor Browser is the only way to truly browse the internet anonymously. When you use Brave, we recommend changing the following settings to protect your privacy from certain parties, but all browsers other than the [Tor Browser](tor.md#tor-browser) will be traceable by *somebody* in some regard or another.
-These options can be found in :material-menu: → **Settings** → **Brave Shields & privacy**
+=== "Android"
-#### Shields
+ These options can be found in :material-menu: → **Settings** → **Brave Shields & privacy**.
-Brave includes some anti-fingerprinting measures in its [Shields](https://support.brave.com/hc/articles/360022973471-What-is-Shields) feature. We suggest configuring these options [globally](https://support.brave.com/hc/articles/360023646212-How-do-I-configure-global-and-site-specific-Shields-settings) across all pages that you visit.
+=== "iOS"
+
+ These options can be found in :fontawesome-solid-ellipsis: → **Settings** → **Shields & Privacy**.
#### Brave shields global defaults
+Brave includes some anti-fingerprinting measures in its [Shields](https://support.brave.com/hc/articles/360022973471-What-is-Shields) feature. We suggest configuring these options [globally](https://support.brave.com/hc/articles/360023646212-How-do-I-configure-global-and-site-specific-Shields-settings) across all pages that you visit.
+
Shields' options can be downgraded on a per-site basis as needed, but by default we recommend setting the following:
-
+=== "Android"
-- [x] Select **Aggressive** under **Block trackers & ads**
+
+
+ - [x] Select **Aggressive** under *Block trackers & ads*
+ - [x] Select **Auto-redirect AMP pages**
+ - [x] Select **Auto-redirect tracking URLs**
+ - [x] Select **Require all connections to use HTTPS (strict)** under *Upgrade connections to HTTPS*
+ - [x] (Optional) Select **Block Scripts** (1)
+ - [x] Select **Block third-party cookies** under *Block Cookies*
+ - [x] Select **Block Fingerprinting**
+ - [x] Select **Prevent fingerprinting via language settings**
-
-Use default filter lists
+
+ Use default filter lists
-Brave allows you to select additional content filters within the internal `brave://adblock` page. We advise against using this feature; instead, keep the default filter lists. Using extra lists will make you stand out from other Brave users and may also increase attack surface if there is an exploit in Brave and a malicious rule is added to one of the lists you use.
+ Brave allows you to select additional content filters within the **Content Filtering** menu or the internal `brave://adblock` page. We advise against using this feature; instead, keep the default filter lists. Using extra lists will make you stand out from other Brave users and may also increase attack surface if there is an exploit in Brave and a malicious rule is added to one of the lists you use.
-
+
+
+ - [x] Select **Forget me when I close this site**
-- [x] Select **Auto-redirect AMP pages**
-- [x] Select **Auto-redirect tracking URLs**
-- [x] Select **strict** under **Upgrade connections to HTTPS**
-- [x] (Optional) Select **Block Scripts** (1)
-- [x] Select **Block third-party cookies** under **Block Cookies**
-- [x] Select **Block fingerprinting**
-- [x] Select **Prevent fingerprinting via language settings**
+
-
+ 1. This option disables JavaScript, which will break a lot of sites. To unbreak them, you can set exceptions on a per-site basis by tapping on the Shield icon in the address bar and unchecking this setting under *Advanced controls*.
+
+=== "iOS"
-1. This option provides functionality similar to uBlock Origin's advanced [blocking modes](https://github.com/gorhill/uBlock/wiki/Blocking-mode) or the [NoScript](https://noscript.net) extension.
+
+
+ - [x] Select **Aggressive** under *Trackers & Ads Blocking*
+ - [x] Select **Strict** under *Upgrade Connections to HTTPS*
+ - [x] Select **Auto-Redirect AMP pages**
+ - [x] Select **Auto-Redirect Tracking URLs**
+ - [x] (Optional) Select **Block Scripts** (1)
+ - [x] Select **Block Fingerprinting**
+
+
+ Use default filter lists
-#### Clear browsing data
+ Brave allows you to select additional content filters within the **Content Filtering** menu. We advise against using this feature; instead, keep the default filter lists. Using extra lists will make you stand out from other Brave users and may also increase attack surface if there is an exploit in Brave and a malicious rule is added to one of the lists you use.
+
+
+
+
+
+ 1. This option disables JavaScript, which will break a lot of sites. To unbreak them, you can set exceptions on a per-site basis by tapping on the Shield icon in the address bar and unchecking this setting under *Advanced controls*.
+
+##### Clear browsing data (Android only)
- [x] Select **Clear data on exit**
-#### Social Media Blocking
+##### Social Media Blocking (Android only)
- [ ] Uncheck all social media components
#### Other privacy settings
+=== "Android"
+
+
+
+ - [x] Select **Disable non-proxied UDP** under [*WebRTC IP handling policy*](https://support.brave.com/hc/articles/360017989132-How-do-I-change-my-Privacy-Settings#webrtc)
+ - [x] (Optional) Select **No protection** under *Safe Browsing* (1)
+ - [ ] Uncheck **Allow sites to check if you have payment methods saved**
+ - [x] Select **Close tabs on exit**
+ - [ ] Uncheck **Allow privacy-preserving product analytics (P3A)**
+ - [ ] Uncheck **Automatically send diagnostic reports**
+ - [ ] Uncheck **Automatically send daily usage ping to Brave**
+
+
+
+ 1. Brave's [implementation of Safe Browsing](https://support.brave.com/hc/en-us/articles/15222663599629-Safe-Browsing-in-Brave) on Android **does not** proxy [Safe Browsing network requests](https://developers.google.com/safe-browsing/v4/update-api#checking-urls) like its desktop counterpart. This means that your IP address may be seen (and logged) by Google. Note that Safe Browsing is not available for Android devices without Google Play Services.
+
+=== "iOS"
+
+ - [ ] Uncheck **Allow Privacy-Preserving Product Analytics (P3A)**
+ - [ ] Uncheck **Automatically send daily usage ping to Brave**
+
+### Leo
+
+These options can be found in :material-menu: → **Settings** → **Leo**.
+
-- [x] Select **Disable non-proxied UDP** under [WebRTC IP handling policy](https://support.brave.com/hc/articles/360017989132-How-do-I-change-my-Privacy-Settings#webrtc)
-- [x] (Optional) Select **No protection** under **Safe Browsing** (1)
-- [ ] Uncheck **Allow sites to check if you have payment methods saved**
-- [ ] Uncheck **IPFS Gateway** (2)
-- [x] Select **Close tabs on exit**
-- [ ] Uncheck **Allow privacy-preserving product analytics (P3A)**
-- [ ] Uncheck **Automatically send diagnostic reports**
-- [ ] Uncheck **Automatically send daily usage ping to Brave**
+- [ ] Uncheck **Show autocomplete suggestions in address bar** (1)
-1. Brave's [implementation of Safe Browsing](https://support.brave.com/hc/en-us/articles/15222663599629-Safe-Browsing-in-Brave) on Android **does not** proxy [Safe Browsing network requests](https://developers.google.com/safe-browsing/v4/update-api#checking-urls) like its desktop counterpart. This means that your IP address may be seen (and logged) by Google. Note that Safe Browsing is not available for Android devices without Google Play Services.
-2. InterPlanetary File System (IPFS) is a decentralized, peer-to-peer network for storing and sharing data in a distributed filesystem. Unless you use the feature, disable it.
-
-### Leo
-
-These options can be found in :material-menu: → **Settings** → **Leo**
-
-- [ ] Uncheck **Show autocomplete suggestions in address bar**
+1. This option is not present in Brave's iOS app.
### Brave Sync