Skip to content
10 changes: 4 additions & 6 deletions docs/adguard-browser-extension/availability.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,18 +9,16 @@ This article is about AdGuard Browser Extension, which safeguards only your brow

:::

[AdGuard Browser Extension](https://adguard.com/adguard-browser-extension/overview.html) is a free extension that works in five popular browsers: Chrome, Firefox, Edge, Opera, and Yandex Browser. You can easily find it in your browser’s online store or on our official website.
[AdGuard Browser Extension](https://adguard.com/adguard-browser-extension/overview.html) is a free extension that works in five popular browsers: Chrome, Firefox, Edge, Opera, and Yandex Browser. You can find and install it via your browser’s web store or download it from our official website.

![AdGuard Browser Extension for Chrome *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_overview.png)

Browser extensions include basic ad-blocking features but cannot be compared with full-featured desktop programs, such as [AdGuard for Windows](/adguard-for-windows/features/home-screen) and [AdGuard for Mac](/adguard-for-mac/features/main).

![Available for most popular browsers *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_availability.png)
![Available for most popular browsers *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/extension_for_browsers.png)

:::note

We have a standalone extension for Safari. Since the release of [Safari 13](https://adguard.com/en/blog/adguard-safari-1-5.html), most of the ad-blocking extensions have experienced huge issues and many of them stopped functioning. We had to develop a [separate extension for Safari](/adguard-for-safari/features/general) that has some differences in comparison with the extension described in this article.
We have a standalone extension for Safari [AdGuard Mini for Mac](/adguard-mini-for-mac/) (formerly AdGuard for Safari). Due to the unique architecture and strict requirements of Safari’s extension framework, it was developed as a separate application and has some functional differences compared to the extension described in this article.

:::

**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](/adguard-browser-extension/comparison-standalone).
**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** While extensions provide essential ad-blocking features, they cannot match the system-wide capabilities of desktop programs like [AdGuard for Windows](/adguard-for-windows/) and [AdGuard for Mac](/adguard-for-mac/). If you are looking for comprehensive protection that goes beyond the browser, you can read more about the [benefits of standalone apps](/adguard-browser-extension/comparison-standalone).
4 changes: 2 additions & 2 deletions docs/adguard-browser-extension/compatibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,13 @@ This article is about AdGuard Browser Extension, which safeguards only your brow

While AdGuard Browser Extension can block ads in browsers, [AdGuard standalone programs](/adguard-browser-extension/comparison-standalone) filter all the traffic on your device, including from browsers and apps.

If you decide to install both the extension and the standalone program on your PC, you may encounter some compatibility issues. The problem is that in some cases the application and the extension may interfere with each other. Some websites will no longer be protected by the desktop program and will only be protected by the extension, which has fewer options. Also, filtering may work incorrectly for some websites. Therefore, we don't recommend using the extension together with the application.
If you decide to install both the extension and the standalone program on your PC, you may encounter some compatibility issues. The problem is that in some cases the application and the extension may interfere with each other. Some websites will no longer be protected by the desktop program and will only be protected by the extension, which has fewer options. Also, filtering may work incorrectly for some websites. Therefore, we dont recommend using the extension together with the application.

If you have the desktop version of AdGuard installed on your PC, it is better to use AdGuard Browser Assistant instead of the extension.

## AdGuard Browser Assistant

![AdGuard Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/ad_blocker_browser_extension_assistant.png)
![AdGuard Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/browser_assistant.png)

AdGuard Browser Assistant is a browser extension that works and feels just like AdGuard Browser Extension, but it's much lighter and doesn't interfere with the desktop apps. You can [read more about Browser Assistant for Windows](/adguard-for-windows/browser-assistant) or [Mac](/adguard-for-mac/features/browser-assistant), or [download it from our website](https://adguard.com/adguard-assistant/overview.html).

Expand Down
59 changes: 40 additions & 19 deletions docs/adguard-browser-extension/features/filters.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,50 +9,71 @@ This article is about AdGuard Browser Extension, which safeguards only your brow

:::

Blocking ads is the key functionality of any ad blocker, and AdGuard Browser Extension is not an exception. Ad blocking is based on filters — sets of rules written in a special language. These rules tell which elements should be blocked and which should not. AdGuard interpretes the rules and modifies web requests based on them. As a result, you stop seeing ads on your webpages.
- [Custom filters](#custom-filters)
- [User rules](#user-rules)
- [Allowlist](#allowlist)

![Filters *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_filters.png)
Blocking ads is the core functionality of any ad blocker, and AdGuard Browser Extension is no exception. Ad blocking is based on filters — sets of rules written in a special language. These rules define which page elements should be blocked and which should not. AdGuard interprets these rules and modifies web requests accordingly. As a result, you stop seeing ads on your webpages.

All filters are grouped according to their role. For example, there are categories for ad-blocking filters, privacy protection filters, social media-related filters, etc. You can enable either individual filters or the entire group at once.
![Filters *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/filters.png)

![Ad blocking filters *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_filters1.png)
All filters are grouped by category based on their role:

## Custom filters
- Ad blocking: Block various types of advertisements
- Privacy: Block online trackers and analytical systems to protect your data
- Social widgets: Block social media elements like *Like* and *Share* buttons
- Annoyances: Block irritating web elements, such as cookie notices, third-party widgets, or in-page popups
- Security: Block requests to phishing and malicious websites
- Other: Contain miscellaneous filters that do not fit into the main categories
- Language-specific: Block ads on websites in specific languages
- Custom: Allow you to add your own filters from a local file or URL

You can enable either individual filters or entire groups at once.

![Security filters *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/security_filters.png)

## Custom filters {#custom-filters}

While the features of other filter groups are more or less self-explanatory, there is a group called *Custom* that may raise additional questions.

![Custom filters *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_custom_filters.png)
![Custom filters *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/custom_filters.png)

In this tab, you can add filters that are not present in the extension by default. There are plenty of [publicly available filters on the Internet](https://filterlists.com). Moreover, you can create and add your own filters. In fact, you can build any set of filters and customize ad blocking the way you like.
In this tab, you can add filters that are not included in the extension by default. There are plenty of [publicly available filters on the Internet](https://filterlists.com). Moreover, you can create and add your own filters. In fact, you can build any set of filters and customize ad blocking the way you like.

To add a filter, just click *Add custom filter*, enter the URL or the file path of the filter you want to be added and click *Next*.

![Add a custom filter *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_custom_filters1.png)
![Add a custom filter *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/add_filter.png)

Custom filters update independently, so your filtering remains effective and current without requiring extension updates.
Custom filters update independently, keeping your protection effective and up to date without requiring extension updates.

## User rules {#user-rules}

*User rules* is another tool that helps you customize the blocking of ads.

![User rules *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_user_rules.png)
![User rules *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/user_rules.png)

There are several ways to add new rules. The most straightforward is to just type a rule in, but it requires some knowledge of the [rule syntax](/general/ad-filtering/create-own-filters).

You can import a ready-to-use filter list from a text file as well. **Make sure that different rules are separated by line breaks.** Note that importing a ready-to-use filter list is better done in the Custom filters tab.
You can import a ready-to-use filter list from a text file as well. **Make sure that different rules are separated by line breaks.**

:::note

Importing a ready-to-use filter list is better done in the *Custom filters* tab.

:::

Besides, you can export your own filtering rules. This option is good for transferring your list of rules between browsers or devices.
You can export your own filtering rules. This option is good for transferring your list of rules between browsers or devices.

When you add a website to the Allowlist (more on that below) or use the Assistant tool for hiding an element on the page, a corresponding rule is also saved in *User rules*.
When you add a website to *Allowlist* or use the Assistant tool to hide an element on a page, the corresponding rule is automatically saved in *User rules*.

## Allowlist
## Allowlist {#allowlist}

The *allowlist* is used to exclude certain websites from filtering. Blocking rules are not applied to the websites on the list.
*Allowlist* is used to exclude specific websites from filtering. None of the blocking rules will apply to the websites on this list.

![Allowlist *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_allowlist.png)
![Allowlist *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/allowlist.png)

*Allowlist* can also be inverted: you can unblock ads everywhere except on the websites added to this list. To do that, activate the *Invert Allowlist* option. Before it turns on, a confirmation dialog will appear to prevent accidental activation and explain what will happen.
*Allowlist* can also be inverted, allowing you to unblock ads everywhere except on the websites added to this list. To do this, go to *Additional settings* and enable *Invert Allowlist*. Before it activates, a confirmation dialog will appear to explain how it works and prevent accidental activation.

![Invert allowlist *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_allowlist1.png)
![Invert allowlist *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/invert_allowlist_dialog.png)

You can also import and export existing allowlists. It is useful, for instance, if you want to apply the same allowing rules in each of your browsers.
You can also import and export existing allowlists. It is useful if you want to apply the same rules across all your browsers.
14 changes: 9 additions & 5 deletions docs/adguard-browser-extension/features/main-menu.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,16 @@ This article is about AdGuard Browser Extension, which safeguards only your brow

:::

The extension's main page can be accessed by clicking the extension's icon on the toolbar of your browser.
The extensions main page can be accessed by clicking its icon on your browser’s toolbar.

![Main menu *mobile_border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_main.png)
![Main menu *mobile_border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/main_popup_mv2.png)

On the main page, you can hide any element on any page manually (a corresponding rule will be added to the *User rules*), open the *Filtering log* to view the complete information about your browser's traffic and block requests on the go, or look at a website’s security report. Besides, you can submit a complaint about any website (for example, if there are missed ads on the page, our filter engineers will review the report and fix the problem) and see the statistics on applied blocking rules.
From the main page, you can manage your protection and access key features:

All web requests made by the browser are displayed in the *Filtering log*, along with detailed information about each request. The *Filtering log* makes it easy, for example, to monitor requests blocked by AdGuard Browser Extension. Besides, it allows you to block any request or add a previously blocked request to Allowlist in two clicks. The *Filtering log* also offers you a wide variety of options for sorting web requests, which can be helpful when creating your own filtering rules. You can open the *Filtering log* by selecting the corresponding item in the main menu, or from the settings page (in the *Additional settings* tab).
- Manually hide any element on a webpage (a custom rule will be automatically added to your *User rules*)
- Open *Filtering log* to view detailed information about your browser’s traffic and block requests on the fly
- Submit a complaint about missed ads or broken page elements so our filter engineers can review and fix the issue
- Check a website’s security report
- See statistics on all blocked elements

By clicking the icons in the top right corner of the extension's main menu, you can open the extension settings or pause the protection.
By clicking the icons in the top-right corner of the extensions main menu, you can manually update filters, pause protection, or open the extension settings.
22 changes: 14 additions & 8 deletions docs/adguard-browser-extension/features/other-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,27 +9,33 @@ This article is about AdGuard Browser Extension, which safeguards only your brow

:::

Apart from the large key modules of AdGuard Browser Extension, there are several more specific features that can be configured in the *General* and *Additional settings* tabs of the extension settings.
Apart from the main settings of AdGuard Browser Extension, there are several more specific features that can be configured in the [*General*](#general) and [*Additional settings*](#misc) tabs.

## General {#general}

The *General* tab contains the main extension settings and lets you control its basic filtering behavior. Here you can allow search ads and [self‑promotion on websites](/general/ad-filtering/search-ads/), enable automatic activation of language-specific filters, set the update interval for the filters, and turn on [protection against phishing and malicious websites](/general/browsing-security/).

![General *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/general_new.png)
![General settings *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/general_settings.png)

You can also save your current configuration and quickly apply it to another browser or device. To do this, click *Share settings* in the *General* tab: the extension will generate a special link and a QR code that contain your current settings. You can either copy the link and open it in a browser, or scan the QR code on a device with AdGuard to open the link directly in the app. You will then see a prompt to apply the shared configuration so that you can restore the same setup after reinstalling your browser or on a new device.
You can also save your current configuration and quickly apply it to another browser or device. To do this, click *Share settings*: the extension will generate a special link and a QR code that contain your current settings. You can either copy the link and open it in a browser, or scan the QR code on a device with AdGuard to open the link directly in the app. You will then see a prompt to apply the shared configuration so that you can restore the same setup after reinstalling your browser or on a new device.

If needed, you can also share this link with other people or attach it to a support request so the team can see your exact configuration.

In addition, you can still export your settings to a .json file by clicking *Export settings* and import them via the *Import settings* option. This makes it easy to switch between different configuration profiles or move them between browsers.

## Additional settings {#misc}

The *Additional settings* section contains a range of various settings that are related to the ad blocking process and application usability.
The *Additional settings* section contains various settings that are related to the ad-blocking process and usability.

![Additional settings *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/additional_new.png)
![Additional settings *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/additional_settings.png)

From this tab, you can invert the allowlist and add the AdGuard item to the browser’s context menu. You can also enable the display of the number of blocked ads on the AdGuard icon and notifications about extension updates. Additionally, this section lets you enable notifications about the AdGuard app, open the *Filtering log*, clear the statistics of blocked ads and trackers, or reset the settings.
Enabling *Use optimized filters* activates lightweight versions of the ad-blocking rules. It focuses only on the most popular filters to save internet traffic and system memory, which is ideal for mobile browsing.

You can invert the *Allowlist* will unblock ads on all websites by default, except for the specific domains you manually add to your list

You can also add the AdGuard item to the browser’s context menu, enable the display of the number of blocked ads on the AdGuard icon, and toggle notifications about extension updates.

Additionally, this section lets you enable notifications about the AdGuard app, open the *Filtering log*, clear the statistics of blocked ads and trackers, or reset the settings.

Besides, you can opt to help us with the development of filters by sending the statistics on applied rules: which ones are triggered, on which websites, and how often. This option is disabled by default as we do not collect user data without consent. Yet, if you enable it, all data will be strictly anonymized.

Expand All @@ -43,6 +49,6 @@ The *Send anonymized usage data* option can also be enabled on the post-installa

## About {#about}

In the *About* section, you can find info about the current version, links to the EULA and Privacy policy, and to the repository of the Browser extension on GitHub.
In the *About* section, you can find information about the current version, links to the Privacy policy, and a link to the repository of the Browser Extension on GitHub.

![About *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/about_new.png)
![About *border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/about.png)
Loading
Loading