From bb52c149430c24644296d555cb08bc282c730cca Mon Sep 17 00:00:00 2001 From: abolshova-a11y Date: Fri, 23 Oct 2026 15:53:53 +0300 Subject: [PATCH 1/4] update-system-wide-protection-article added a caution note about system-wide protection being an experimental feature due to an unresolved bug on apple's side; swp won't work correctly on 27.2 beta, if it works fine on an earlier macOS version we recommend waiting to update until apple resolves the bug. the v3 beta shows system-wide protection by default, it is hidden in the release version, added an explanation on how to toggle it on in settings in the intro and in the troubleshooting section. --- .../features/system-wide-protection.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/adguard-mini-for-mac/features/system-wide-protection.md b/docs/adguard-mini-for-mac/features/system-wide-protection.md index 5cc6180dbf6..96ebb53536e 100644 --- a/docs/adguard-mini-for-mac/features/system-wide-protection.md +++ b/docs/adguard-mini-for-mac/features/system-wide-protection.md @@ -6,6 +6,16 @@ Starting with version 3.0, AdGuard Mini for Mac introduces *System-wide protecti The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click *Try for free* in *Advanced protection* to start a 14-day free trial. +:::caution + +*System-wide protection* is an experimental feature. It may not work for everyone due to [an unresolved bug on Apple’s side](https://developer.apple.com/forums/thread/848364). Once the feature is stable for everyone, we’ll make it a core part of AdGuard Mini. + +::: + +The feature currently does not work correctly on **macOS 27.2 beta**. If you're on **macOS 26.0 and 27.0**, you can try *System-wide protection* as usual. Note that if *System-wide protection* works fine for you on macOS 27.0, it will most likely break after you update to macOS 27.2. Keep this in mind before you update your system. + +In the release version, *System-wide protection* is hidden by default. To show it, go to *Settings* → *Miscellaneous* and turn on *Show System-wide protection (Experimental)*. The beta version always shows it. + ## How it works *System-wide protection* is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. @@ -44,6 +54,10 @@ There are three levels of protection you can choose from. *Essential* is selecte ## Troubleshooting +### System-wide protection doesn’t work on macOS 27.2 + +This is caused by [an unresolved bug on Apple’s side](https://developer.apple.com/forums/thread/848364). Because of it, *System-wide protection* is currently an experimental feature. It works on macOS 26 and 27.0, but may not work correctly on macOS 27.2 beta. If you’re on an earlier macOS version, we recommend staying on it until Apple fixes the bug. + ### System-wide protection doesn’t work with every app or browser Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. @@ -54,6 +68,7 @@ Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own n - **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to *Update to macOS Tahoe 26 or later*. - **Your account isn’t supported.** *System-wide protection* only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows *Not supported on this Mac account*. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **The setting is hidden.** In the release version, *System-wide protection* is hidden by default. Go to *Settings* → *Miscellaneous* and turn on *Show System-wide protection (Experimental)*. - **You’re on the free version.** To use *System-wide protection*, [purchase an AdGuard license](https://adguard.com/license.html) or click *Try for free* in *Advanced protection* to start a 14-day free trial. ### Can I change my Mac account’s user ID? From a82275b2c9c74600537563ef11f73a3a4a96a2ab Mon Sep 17 00:00:00 2001 From: Alyona Bolshova Date: Mon, 26 Oct 2026 17:58:49 +0300 Subject: [PATCH 2/4] Apply batched suggestions from code review Co-authored-by: Anna Koroleva --- .../adguard-mini-for-mac/features/system-wide-protection.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/adguard-mini-for-mac/features/system-wide-protection.md b/docs/adguard-mini-for-mac/features/system-wide-protection.md index 96ebb53536e..6e9a7615845 100644 --- a/docs/adguard-mini-for-mac/features/system-wide-protection.md +++ b/docs/adguard-mini-for-mac/features/system-wide-protection.md @@ -8,11 +8,11 @@ The feature is available for users with an AdGuard license. You can [purchase th :::caution -*System-wide protection* is an experimental feature. It may not work for everyone due to [an unresolved bug on Apple’s side](https://developer.apple.com/forums/thread/848364). Once the feature is stable for everyone, we’ll make it a core part of AdGuard Mini. +*System-wide protection* is an experimental feature. It may not work for everyone due to an [unresolved bug on Apple’s side](https://developer.apple.com/forums/thread/848364). Once the feature is stable for everyone, we’ll make it a core part of AdGuard Mini. ::: -The feature currently does not work correctly on **macOS 27.2 beta**. If you're on **macOS 26.0 and 27.0**, you can try *System-wide protection* as usual. Note that if *System-wide protection* works fine for you on macOS 27.0, it will most likely break after you update to macOS 27.2. Keep this in mind before you update your system. +The feature currently does not work correctly on **macOS 27.2 beta**. If you’re on **macOS 26.0 and 27.0**, you can try *System-wide protection* as usual. Note that if *System-wide protection* works fine for you on macOS 27.0, it will most likely break after you update to macOS 27.2. Keep this in mind before you update your system. In the release version, *System-wide protection* is hidden by default. To show it, go to *Settings* → *Miscellaneous* and turn on *Show System-wide protection (Experimental)*. The beta version always shows it. @@ -56,7 +56,7 @@ There are three levels of protection you can choose from. *Essential* is selecte ### System-wide protection doesn’t work on macOS 27.2 -This is caused by [an unresolved bug on Apple’s side](https://developer.apple.com/forums/thread/848364). Because of it, *System-wide protection* is currently an experimental feature. It works on macOS 26 and 27.0, but may not work correctly on macOS 27.2 beta. If you’re on an earlier macOS version, we recommend staying on it until Apple fixes the bug. +This is caused by an [unresolved bug on Apple’s side](https://developer.apple.com/forums/thread/848364). Because of it, *System-wide protection* is currently an experimental feature. It works on macOS 26 and 27.0, but may not work correctly on macOS 27.2 beta. If you’re on an earlier macOS version, we recommend staying on it until Apple fixes the bug. ### System-wide protection doesn’t work with every app or browser From 386ce72ccd45da8df04891a5795cbed334e917bb Mon Sep 17 00:00:00 2001 From: abolshova-a11y Date: Mon, 26 Oct 2026 18:08:30 +0300 Subject: [PATCH 3/4] Update system-wide-protection.md added screenshot of the swp experimental toggle --- docs/adguard-mini-for-mac/features/system-wide-protection.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/adguard-mini-for-mac/features/system-wide-protection.md b/docs/adguard-mini-for-mac/features/system-wide-protection.md index 6e9a7615845..4b17c9c8c6b 100644 --- a/docs/adguard-mini-for-mac/features/system-wide-protection.md +++ b/docs/adguard-mini-for-mac/features/system-wide-protection.md @@ -16,6 +16,8 @@ The feature currently does not work correctly on **macOS 27.2 beta**. If you’r In the release version, *System-wide protection* is hidden by default. To show it, go to *Settings* → *Miscellaneous* and turn on *Show System-wide protection (Experimental)*. The beta version always shows it. +![Experimental toggle](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/swp-experimental-toggle.png) + ## How it works *System-wide protection* is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. From fd907801c7b4e80f448cf86ac7e45d50c93800cc Mon Sep 17 00:00:00 2001 From: abolshova-a11y Date: Fri, 30 Oct 2026 18:14:49 +0300 Subject: [PATCH 4/4] Update system-wide-protection.md --- docs/adguard-mini-for-mac/features/system-wide-protection.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/adguard-mini-for-mac/features/system-wide-protection.md b/docs/adguard-mini-for-mac/features/system-wide-protection.md index 4b17c9c8c6b..4960cf1af31 100644 --- a/docs/adguard-mini-for-mac/features/system-wide-protection.md +++ b/docs/adguard-mini-for-mac/features/system-wide-protection.md @@ -12,7 +12,7 @@ The feature is available for users with an AdGuard license. You can [purchase th ::: -The feature currently does not work correctly on **macOS 27.2 beta**. If you’re on **macOS 26.0 and 27.0**, you can try *System-wide protection* as usual. Note that if *System-wide protection* works fine for you on macOS 27.0, it will most likely break after you update to macOS 27.2. Keep this in mind before you update your system. +The feature does not work correctly on some macOS versions, including **26.7.2** and **27.2**. If you’re on **macOS 26.0 and 27.0**, you can try *System-wide protection* as usual. Note that if *System-wide protection* works fine for you on macOS 27.0, it will most likely break after you update to macOS 27.2. Keep this in mind before you update your system. In the release version, *System-wide protection* is hidden by default. To show it, go to *Settings* → *Miscellaneous* and turn on *Show System-wide protection (Experimental)*. The beta version always shows it.