From 285b7eaca867bdc91c112957ef5e54f03b6ea605 Mon Sep 17 00:00:00 2001 From: Anastasiia Fedotova Date: Fri, 2 Oct 2026 13:38:01 +0300 Subject: [PATCH 1/7] [AGM-3116] Improved instructions for granting browser folder permissions --- .../browser-assistant-macos-27.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 82f87ea1a8d..e081054a8eb 100644 --- a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,15 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +Since this issue can affect any Chromium- or Gecko-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. ### Step 1: Grant access via Files & Folders 1. Open *Files & Folders* - - via AdGuard settings: click the gear icon on the app’s main window → *Preferences…* → the *Assistant* tab → *Open Files & Folders* - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click *Open Files & Folders* — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click *Allow Access...* — this button appears if AdGuard doesn’t have access to the browser’s folder. You’ll be taken directly to the *Files & Folders* section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via AdGuard main window: click *Allow access to your browser folder for the Assistant* at the bottom → on the *Assistant tab*, click *Allow Access...*; or click the gear icon in the top-right corner → *Preferences…* → the *Assistant tab* → *Allow Access...* + ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) - via *System Settings* → *Privacy & Security* → *Files & Folders* ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 1. Find *AdGuard* in the list and click it to expand the dropdown @@ -46,6 +46,12 @@ Some browsers, like Opera, rely on the Native Messaging folder that belongs to G **Option B: Grant Full Disk Access** +:::note + +Granting *Full Disk Access* is a last-resort measure: we strongly recommend trying the options above first. You should only enable it if you fully understand what you are doing. Full Disk Access is not required for AdGuard to work properly. + +::: + 1. Open *System Settings* → *Privacy & Security* → *Full Disk Access* 1. Find *AdGuard* in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) From d367a3d58d88cd019530aba9d76dbeeefedf7044 Mon Sep 17 00:00:00 2001 From: Anastasiia Fedotova Date: Fri, 2 Oct 2026 13:45:55 +0300 Subject: [PATCH 2/7] formatting fix --- .../solving-problems/browser-assistant-macos-27.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index e081054a8eb..be5ea1aadc5 100644 --- a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -21,7 +21,7 @@ Since this issue can affect any Chromium- or Gecko-based browser, this section c - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click *Allow Access...* — this button appears if AdGuard doesn’t have access to the browser’s folder. You’ll be taken directly to the *Files & Folders* section ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) - via AdGuard main window: click *Allow access to your browser folder for the Assistant* at the bottom → on the *Assistant tab*, click *Allow Access...*; or click the gear icon in the top-right corner → *Preferences…* → the *Assistant tab* → *Allow Access...* - ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) + ![AdGuard popup *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) - via *System Settings* → *Privacy & Security* → *Files & Folders* ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 1. Find *AdGuard* in the list and click it to expand the dropdown From eb54b3ea181b1151dec644e45ee49cc3516e813c Mon Sep 17 00:00:00 2001 From: Anastasiia Fedotova Date: Fri, 2 Oct 2026 13:53:32 +0300 Subject: [PATCH 3/7] screenshot formatting --- .../solving-problems/browser-assistant-macos-27.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index be5ea1aadc5..bf24bb47c82 100644 --- a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -21,7 +21,10 @@ Since this issue can affect any Chromium- or Gecko-based browser, this section c - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click *Allow Access...* — this button appears if AdGuard doesn’t have access to the browser’s folder. You’ll be taken directly to the *Files & Folders* section ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) - via AdGuard main window: click *Allow access to your browser folder for the Assistant* at the bottom → on the *Assistant tab*, click *Allow Access...*; or click the gear icon in the top-right corner → *Preferences…* → the *Assistant tab* → *Allow Access...* - ![AdGuard popup *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) +
+ AdGuard popup + AdGuard settings +
- via *System Settings* → *Privacy & Security* → *Files & Folders* ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 1. Find *AdGuard* in the list and click it to expand the dropdown @@ -40,7 +43,7 @@ A toggle for a specific browser will only appear in this list if the browser is Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. 1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -1. Open *Files & Folders* (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Open *Files & Folders* (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 1. Find *AdGuard* in the list and click it to expand the dropdown 1. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). From 5aa0daa1189bd8f0c4c2373112542dfe39be8004 Mon Sep 17 00:00:00 2001 From: Anastasiia Fedotova Date: Fri, 2 Oct 2026 13:57:00 +0300 Subject: [PATCH 4/7] div fixes --- .../solving-problems/browser-assistant-macos-27.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index bf24bb47c82..d3f26357fdf 100644 --- a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -21,10 +21,12 @@ Since this issue can affect any Chromium- or Gecko-based browser, this section c - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click *Allow Access...* — this button appears if AdGuard doesn’t have access to the browser’s folder. You’ll be taken directly to the *Files & Folders* section ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) - via AdGuard main window: click *Allow access to your browser folder for the Assistant* at the bottom → on the *Assistant tab*, click *Allow Access...*; or click the gear icon in the top-right corner → *Preferences…* → the *Assistant tab* → *Allow Access...* -
- AdGuard popup - AdGuard settings -
+ +
+ AdGuard popup + AdGuard settings +
+ - via *System Settings* → *Privacy & Security* → *Files & Folders* ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 1. Find *AdGuard* in the list and click it to expand the dropdown From 683850c56ee529859e73f97a37ac9a9589cf22d2 Mon Sep 17 00:00:00 2001 From: Anastasiia Fedotova Date: Fri, 2 Oct 2026 14:01:56 +0300 Subject: [PATCH 5/7] one more screenshot fix --- .../solving-problems/browser-assistant-macos-27.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index d3f26357fdf..343d0a8d5b9 100644 --- a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -22,10 +22,8 @@ Since this issue can affect any Chromium- or Gecko-based browser, this section c ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) - via AdGuard main window: click *Allow access to your browser folder for the Assistant* at the bottom → on the *Assistant tab*, click *Allow Access...*; or click the gear icon in the top-right corner → *Preferences…* → the *Assistant tab* → *Allow Access...* -
- AdGuard popup - AdGuard settings -
+ | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | +| :-: | :-: | - via *System Settings* → *Privacy & Security* → *Files & Folders* ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) From 479f0074ce6aad45dcf78bb25746dc3bc74b5f16 Mon Sep 17 00:00:00 2001 From: Anastasiia Fedotova Date: Fri, 2 Oct 2026 14:10:30 +0300 Subject: [PATCH 6/7] one more try --- .../solving-problems/browser-assistant-macos-27.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 343d0a8d5b9..367876621c9 100644 --- a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -22,8 +22,9 @@ Since this issue can affect any Chromium- or Gecko-based browser, this section c ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) - via AdGuard main window: click *Allow access to your browser folder for the Assistant* at the bottom → on the *Assistant tab*, click *Allow Access...*; or click the gear icon in the top-right corner → *Preferences…* → the *Assistant tab* → *Allow Access...* - | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + | | | | :-: | :-: | +| ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | - via *System Settings* → *Privacy & Security* → *Files & Folders* ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) From 63f87a0cd959e9bfd6de89c9c637e211e89ba8dd Mon Sep 17 00:00:00 2001 From: Anastasiia Fedotova Date: Fri, 2 Oct 2026 14:16:32 +0300 Subject: [PATCH 7/7] i'm trying --- .../solving-problems/browser-assistant-macos-27.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 367876621c9..da35e7aee9a 100644 --- a/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/docs/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -23,8 +23,8 @@ Since this issue can affect any Chromium- or Gecko-based browser, this section c - via AdGuard main window: click *Allow access to your browser folder for the Assistant* at the bottom → on the *Assistant tab*, click *Allow Access...*; or click the gear icon in the top-right corner → *Preferences…* → the *Assistant tab* → *Allow Access...* | | | -| :-: | :-: | -| ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + | :-: | :-: | + | ![AdGuard popup *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | - via *System Settings* → *Privacy & Security* → *Files & Folders* ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png)