From 12419010d2fd887645188adea606134f2d1d340d Mon Sep 17 00:00:00 2001 From: Elena Ter-Mikaelyan Date: Mon, 13 Jul 2026 16:51:49 +0300 Subject: [PATCH 1/9] add-info-about-filtering-in-AGW --- .../app-management/app-management.md | 67 +++++++++++++++++-- 1 file changed, 62 insertions(+), 5 deletions(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index 69b4b142601..20c42300426 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -9,8 +9,6 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that ::: -![App management](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/management.png) - In the *App management* section, you can manage routing and filtering settings for all apps installed on your device. Once AdGuard detects that an app has gone online, it is automatically added to *App management*, and its traffic is routed through AdGuard. @@ -25,8 +23,67 @@ You can leave the settings as they are, disable both filtering and routing, or f ![App stats](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/stats_app.png) -## “Problem-free” and “problematic” apps +## How app filtering and routing work in AdGuard for Windows v8.0 + +AdGuard for Windows v8.0 introduces updated logic for handling apps. It helps prevent compatibility issues while still giving you control over which apps are filtered. Let’s break down how it works. + +There are “problem-free” and “problematic” apps. Ones work correctly when filtered, others may not function when their traffic is processed by AdGuard. This can be caused by features like HTTPS interception or proxying. + +To avoid breaking apps out of the box, AdGuard does not filter everything indiscriminately. Instead, it relies on a compatibility list — a set of apps that are known to work correctly with filtering enabled. + +:::note + +“Not filtering everything” does not mean “filter nothing.” Trusted apps (like browsers) are always filtered. + +::: + +Each app has three independent processing layers: traffic routing through AdGuard, filtering (blocking ads and trackers), and HTTPS filtering (interception of encrypted traffic). + +These are determined by three sources: + +- *Compatibility list* + Apps that have been tested by our team and are confirmed to work correctly with filtering. + This list is updated through internal testing and user reports in the [dedicated repository for listing AdGuard compatibility issues](https://github.com/AdguardTeam/CompatibilityIssues) +- *Exclusion lists* + Separate lists for routing, filtering, and HTTPS filtering. These include apps known to break when filtering is applied. +- *Filter unknown apps* + This setting defines how all other apps (not present in any list) are handled. + +:::info + +The compatibility lists are continuously updated — and you can help improve them. If you notice that an app does not work correctly with filtering enabled, report it [on GitHub](https://github.com/AdguardTeam/CompatibilityIssues) or contact support via the app. Your feedback helps improve AdGuard for everyone. + +::: + +## Filter unknown apps + +![Filter unknown apps *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/app-management.png) + +The *Filter unknown apps* setting allows you to choose between two modes — a safe default one where only trusted apps are filtered and a manual one where you decide which apps to filter. It affects only new and unknown applications. -Most apps work correctly when filtered. Some apps are considered “problematic” and may not work correctly when routed through AdGuard. You may see a warning like this when trying to route or filter all apps: +import Tabs from '@theme/Tabs'; -To ensure the proper operation of all apps installed on your device, we recommend routing only problem-free apps through AdGuard. +import TabItem from '@theme/TabItem'; + +:::tip[There are three categories of apps:] + + + Always routed through AdGuard, filtered, and HTTPS-filtered. This setting does not affect them. + Never routed, filtered, or HTTPS-filtered. This setting does not affect them either. + Their behavior depends on the setting. + + +::: + +If the setting is enabled (default), app traffic is routed through AdGuard, regular filtering is applied, and **HTTPS filtering is NOT enabled automatically**. This is intentional: HTTPS interception is the most sensitive part of traffic processing and may affect app behavior. + +If the setting is disabled, the app is not processed by AdGuard at all (not routed), and you must manually enable any processing. + +:::info What happens on reset + +If you click **Reset to default**, two things happen: + +1. All app-specific permissions are cleared (set to “not configured”). +2. Predefined rules are applied to known safe apps (such as browsers), including HTTPS filtering. + +::: From 2e3b2dbef9d6be3fd08b4a047958fde4b50f18d9 Mon Sep 17 00:00:00 2001 From: Elena Ter-Mikaelyan Date: Mon, 13 Jul 2026 16:55:24 +0300 Subject: [PATCH 2/9] remove non-markdown admonitions --- .../app-management/app-management.md | 21 +++++++------------ 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index 20c42300426..e58f84f27f8 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -61,19 +61,14 @@ The compatibility lists are continuously updated — and you can help improve th The *Filter unknown apps* setting allows you to choose between two modes — a safe default one where only trusted apps are filtered and a manual one where you decide which apps to filter. It affects only new and unknown applications. -import Tabs from '@theme/Tabs'; - -import TabItem from '@theme/TabItem'; - -:::tip[There are three categories of apps:] - - - Always routed through AdGuard, filtered, and HTTPS-filtered. This setting does not affect them. - Never routed, filtered, or HTTPS-filtered. This setting does not affect them either. - Their behavior depends on the setting. - - -::: +There are three categories of apps: + +- **Compatible, or problem-free (e.g., browsers)** +Always routed through AdGuard, filtered, and HTTPS-filtered. This setting does not affect them. +- **Problematic apps (from exclusion lists)** +Never routed, filtered, or HTTPS-filtered. This setting does not affect them either. +- **Other (unknown)** +Their behavior depends on the setting. If the setting is enabled (default), app traffic is routed through AdGuard, regular filtering is applied, and **HTTPS filtering is NOT enabled automatically**. This is intentional: HTTPS interception is the most sensitive part of traffic processing and may affect app behavior. From d1ac7684f822bea906fc19464bf5a0425dc30af8 Mon Sep 17 00:00:00 2001 From: Elena Ter-Mikaelyan Date: Mon, 13 Jul 2026 17:01:37 +0300 Subject: [PATCH 3/9] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/adguard-for-windows-8/app-management/app-management.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index e58f84f27f8..1ea3b8cfd29 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -27,7 +27,7 @@ You can leave the settings as they are, disable both filtering and routing, or f AdGuard for Windows v8.0 introduces updated logic for handling apps. It helps prevent compatibility issues while still giving you control over which apps are filtered. Let’s break down how it works. -There are “problem-free” and “problematic” apps. Ones work correctly when filtered, others may not function when their traffic is processed by AdGuard. This can be caused by features like HTTPS interception or proxying. +There are “problem-free” and “problematic” apps. Some work correctly when filtered, while others may not function when their traffic is processed by AdGuard. This can be caused by features like HTTPS interception or proxying. To avoid breaking apps out of the box, AdGuard does not filter everything indiscriminately. Instead, it relies on a compatibility list — a set of apps that are known to work correctly with filtering enabled. From 743c4918b48c70653264c21bf5d71058db27cd1a Mon Sep 17 00:00:00 2001 From: Elena Ter-Mikaelyan Date: Mon, 13 Jul 2026 17:02:01 +0300 Subject: [PATCH 4/9] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/adguard-for-windows-8/app-management/app-management.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index 1ea3b8cfd29..47f57a130bf 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -43,7 +43,7 @@ These are determined by three sources: - *Compatibility list* Apps that have been tested by our team and are confirmed to work correctly with filtering. - This list is updated through internal testing and user reports in the [dedicated repository for listing AdGuard compatibility issues](https://github.com/AdguardTeam/CompatibilityIssues) + This list is updated through internal testing and user reports in the [dedicated repository for listing AdGuard compatibility issues](https://github.com/AdguardTeam/CompatibilityIssues). - *Exclusion lists* Separate lists for routing, filtering, and HTTPS filtering. These include apps known to break when filtering is applied. - *Filter unknown apps* From f7850642888605aa9ba4d5f83651b0be3e5ee72e Mon Sep 17 00:00:00 2001 From: Elena Ter-Mikaelyan Date: Mon, 13 Jul 2026 17:06:45 +0300 Subject: [PATCH 5/9] fix lists --- .../app-management/app-management.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index 47f57a130bf..8205f4405fa 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -42,11 +42,14 @@ Each app has three independent processing layers: traffic routing through AdGuar These are determined by three sources: - *Compatibility list* + Apps that have been tested by our team and are confirmed to work correctly with filtering. This list is updated through internal testing and user reports in the [dedicated repository for listing AdGuard compatibility issues](https://github.com/AdguardTeam/CompatibilityIssues). - *Exclusion lists* + Separate lists for routing, filtering, and HTTPS filtering. These include apps known to break when filtering is applied. - *Filter unknown apps* + This setting defines how all other apps (not present in any list) are handled. :::info @@ -64,11 +67,14 @@ The *Filter unknown apps* setting allows you to choose between two modes — a s There are three categories of apps: - **Compatible, or problem-free (e.g., browsers)** -Always routed through AdGuard, filtered, and HTTPS-filtered. This setting does not affect them. + + Always routed through AdGuard, filtered, and HTTPS-filtered. This setting does not affect them. - **Problematic apps (from exclusion lists)** -Never routed, filtered, or HTTPS-filtered. This setting does not affect them either. + + Never routed, filtered, or HTTPS-filtered. This setting does not affect them either. - **Other (unknown)** -Their behavior depends on the setting. + + Their behavior depends on the setting. If the setting is enabled (default), app traffic is routed through AdGuard, regular filtering is applied, and **HTTPS filtering is NOT enabled automatically**. This is intentional: HTTPS interception is the most sensitive part of traffic processing and may affect app behavior. From 00392a2ef27c6ad7df66985fbebe25d278d252f8 Mon Sep 17 00:00:00 2001 From: Helen Date: Tue, 14 Jul 2026 16:41:07 +0300 Subject: [PATCH 6/9] wording and formatting fixes --- .../app-management/app-management.md | 25 +++++++++---------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index 8205f4405fa..1c9f2060bcc 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -45,9 +45,11 @@ These are determined by three sources: Apps that have been tested by our team and are confirmed to work correctly with filtering. This list is updated through internal testing and user reports in the [dedicated repository for listing AdGuard compatibility issues](https://github.com/AdguardTeam/CompatibilityIssues). + - *Exclusion lists* Separate lists for routing, filtering, and HTTPS filtering. These include apps known to break when filtering is applied. + - *Filter unknown apps* This setting defines how all other apps (not present in any list) are handled. @@ -55,6 +57,7 @@ These are determined by three sources: :::info The compatibility lists are continuously updated — and you can help improve them. If you notice that an app does not work correctly with filtering enabled, report it [on GitHub](https://github.com/AdguardTeam/CompatibilityIssues) or contact support via the app. Your feedback helps improve AdGuard for everyone. +The compatibility lists are continuously updated — and you can help improve them. If you notice that an app does not work correctly with filtering enabled, **report it on [GitHub](https://github.com/AdguardTeam/CompatibilityIssues)** or contact support via the app. Your feedback helps improve AdGuard for everyone. ::: @@ -62,23 +65,19 @@ The compatibility lists are continuously updated — and you can help improve th ![Filter unknown apps *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/app-management.png) -The *Filter unknown apps* setting allows you to choose between two modes — a safe default one where only trusted apps are filtered and a manual one where you decide which apps to filter. It affects only new and unknown applications. - -There are three categories of apps: - -- **Compatible, or problem-free (e.g., browsers)** - - Always routed through AdGuard, filtered, and HTTPS-filtered. This setting does not affect them. -- **Problematic apps (from exclusion lists)** +The *Filter unknown apps* setting allows you to choose between two modes — a safe one where only trusted apps are filtered and a manual one where you decide which apps to filter. - Never routed, filtered, or HTTPS-filtered. This setting does not affect them either. -- **Other (unknown)** +When enabled (default), app traffic is routed through AdGuard, regular filtering is applied, and **HTTPS filtering is NOT enabled automatically**. This is intentional: HTTPS interception is the most sensitive part of traffic processing and may affect app behavior. - Their behavior depends on the setting. +When disabled, new apps are not processed by AdGuard — you will need to manually configure routing for them. -If the setting is enabled (default), app traffic is routed through AdGuard, regular filtering is applied, and **HTTPS filtering is NOT enabled automatically**. This is intentional: HTTPS interception is the most sensitive part of traffic processing and may affect app behavior. +Here is a quick overview of how different app categories behave depending on this setting: -If the setting is disabled, the app is not processed by AdGuard at all (not routed), and you must manually enable any processing. +| App category | Toggle on (default) | Toggle off | +|----------------------|--------------------|------------| +| Compatible, or problem-free (e.g., browsers) | · Routing ✅
· Filtering ✅
· HTTPS filtering ✅ | Same behavior — does not depend on toggle | +| Problematic (from exclusion lists, filtering may cause issues) | · Routing ❌
· Filtering ❌
· HTTPS filtering ❌ | Same behavior — does not depend on toggle | +| Others / (newly detected, unknown, not in lists) | · Routing ✅
· Filtering ✅
· HTTPS filtering ❌ | Not routed through AdGuard, must be enabled manually | :::info What happens on reset From d6898957152d9dcc961c16ec0657de778d5799e0 Mon Sep 17 00:00:00 2001 From: Helen Date: Tue, 14 Jul 2026 16:43:00 +0300 Subject: [PATCH 7/9] place preposition outside the link --- docs/adguard-for-windows-8/app-management/app-management.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index 1c9f2060bcc..45695f65400 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -56,7 +56,6 @@ These are determined by three sources: :::info -The compatibility lists are continuously updated — and you can help improve them. If you notice that an app does not work correctly with filtering enabled, report it [on GitHub](https://github.com/AdguardTeam/CompatibilityIssues) or contact support via the app. Your feedback helps improve AdGuard for everyone. The compatibility lists are continuously updated — and you can help improve them. If you notice that an app does not work correctly with filtering enabled, **report it on [GitHub](https://github.com/AdguardTeam/CompatibilityIssues)** or contact support via the app. Your feedback helps improve AdGuard for everyone. ::: From 3ca4873776db0d3c0c1329937fa7062606bf0876 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 14 Jul 2026 13:49:34 +0000 Subject: [PATCH 8/9] fix: close br tags in app management table for MDX build --- docs/adguard-for-windows-8/app-management/app-management.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index 45695f65400..e95bd8cb405 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -74,9 +74,9 @@ Here is a quick overview of how different app categories behave depending on thi | App category | Toggle on (default) | Toggle off | |----------------------|--------------------|------------| -| Compatible, or problem-free (e.g., browsers) | · Routing ✅
· Filtering ✅
· HTTPS filtering ✅ | Same behavior — does not depend on toggle | -| Problematic (from exclusion lists, filtering may cause issues) | · Routing ❌
· Filtering ❌
· HTTPS filtering ❌ | Same behavior — does not depend on toggle | -| Others / (newly detected, unknown, not in lists) | · Routing ✅
· Filtering ✅
· HTTPS filtering ❌ | Not routed through AdGuard, must be enabled manually | +| Compatible, or problem-free (e.g., browsers) | · Routing ✅
· Filtering ✅
· HTTPS filtering ✅ | Same behavior — does not depend on toggle | +| Problematic (from exclusion lists, filtering may cause issues) | · Routing ❌
· Filtering ❌
· HTTPS filtering ❌ | Same behavior — does not depend on toggle | +| Others / (newly detected, unknown, not in lists) | · Routing ✅
· Filtering ✅
· HTTPS filtering ❌ | Not routed through AdGuard, must be enabled manually | :::info What happens on reset From 821d5189cdf33785b8d818a4f36b12a3da2e1d71 Mon Sep 17 00:00:00 2001 From: Helen Date: Tue, 14 Jul 2026 16:50:32 +0300 Subject: [PATCH 9/9] fix tags in XHTML-style syntax --- .../app-management/app-management.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/adguard-for-windows-8/app-management/app-management.md b/docs/adguard-for-windows-8/app-management/app-management.md index 45695f65400..48069508b62 100644 --- a/docs/adguard-for-windows-8/app-management/app-management.md +++ b/docs/adguard-for-windows-8/app-management/app-management.md @@ -64,9 +64,9 @@ The compatibility lists are continuously updated — and you can help improve th ![Filter unknown apps *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/app-management.png) -The *Filter unknown apps* setting allows you to choose between two modes — a safe one where only trusted apps are filtered and a manual one where you decide which apps to filter. +The *Filter unknown apps* setting is enabled by default and determines how AdGuard handles new apps that are not yet present in the compatibility or exclusion lists -When enabled (default), app traffic is routed through AdGuard, regular filtering is applied, and **HTTPS filtering is NOT enabled automatically**. This is intentional: HTTPS interception is the most sensitive part of traffic processing and may affect app behavior. +When enabled, app traffic is routed through AdGuard, regular filtering is applied, and **HTTPS filtering is NOT enabled automatically**. This is intentional: HTTPS interception is the most sensitive part of traffic processing and may affect app behavior. When disabled, new apps are not processed by AdGuard — you will need to manually configure routing for them. @@ -74,9 +74,9 @@ Here is a quick overview of how different app categories behave depending on thi | App category | Toggle on (default) | Toggle off | |----------------------|--------------------|------------| -| Compatible, or problem-free (e.g., browsers) | · Routing ✅
· Filtering ✅
· HTTPS filtering ✅ | Same behavior — does not depend on toggle | -| Problematic (from exclusion lists, filtering may cause issues) | · Routing ❌
· Filtering ❌
· HTTPS filtering ❌ | Same behavior — does not depend on toggle | -| Others / (newly detected, unknown, not in lists) | · Routing ✅
· Filtering ✅
· HTTPS filtering ❌ | Not routed through AdGuard, must be enabled manually | +| Compatible, or problem-free (e.g., browsers) | · Routing ✅
· Filtering ✅
· HTTPS filtering ✅ | Same behavior — does not depend on toggle | +| Problematic (from exclusion lists, filtering may cause issues) | · Routing ❌
· Filtering ❌
· HTTPS filtering ❌ | Same behavior — does not depend on toggle | +| Others / (newly detected, unknown, not in lists) | · Routing ✅
· Filtering ✅
· HTTPS filtering ❌ | Not routed through AdGuard, must be enabled manually | :::info What happens on reset