|
| 1 | +--- |
| 2 | +title: Safari extensions |
| 3 | +sidebar_position: 3 |
| 4 | +--- |
| 5 | + |
| 6 | +:::info |
| 7 | + |
| 8 | +This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) |
| 9 | + |
| 10 | +::: |
| 11 | + |
| 12 | +## What Safari extensions are |
| 13 | + |
| 14 | +Safari extensions are small software programs that add functionality to the Safari web browser. They allow users to customize and enhance their browsing experience by adding features that are not natively built into the browser. AdGuard Mini for Mac uses extensions primarily to apply filtering rules on websites opened in Safari. |
| 15 | + |
| 16 | +## How it works |
| 17 | + |
| 18 | +To block ads, trackers, and annoyances on websites, AdGuard uses filtering rules. The rules from AdGuard’s and your custom filters are converted into ones comprehensible by Safari and are integrated into 6 Safari extensions: |
| 19 | + |
| 20 | +- AdGuard General |
| 21 | +- AdGuard Privacy |
| 22 | +- AdGuard Social |
| 23 | +- AdGuard Security |
| 24 | +- AdGuard Custom |
| 25 | +- AdGuard Other |
| 26 | + |
| 27 | +Each content-blocking extension can include up to 150,000 active filtering rules. The number of rules within most filter groups does not surpass 150,000. However, if you activate too many language-specific or custom filters, you might exceed the limit. In such cases, random rules that are over the limit will be automatically disabled, which may lead to incorrect blocking. **We strongly recommend activating only the filters you need**. |
| 28 | + |
| 29 | +There is also one more extension responsible for other features: *AdGuard for Safari*, which adds the AdGuard icon next to the search bar in Safari and allows using advanced rules to block complex ads. |
| 30 | + |
| 31 | + |
| 32 | + |
| 33 | +More on each extension below. |
| 34 | + |
| 35 | +## Content-blocking extensions |
| 36 | + |
| 37 | +*AdGuard General* applies rules from filters that you can find in *Settings* → *Filters* → *Ad blocking* and *Language-specific*. This extension focuses on comprehensive ad blocking and includes filters for ads in specific languages. |
| 38 | + |
| 39 | +*AdGuard Privacy* applies rules from filters located in *Filters* → *Privacy*. It blocks tracking mechanisms and ensures that your browsing activity remains private. |
| 40 | + |
| 41 | +*AdGuard Social* applies rules from filters that can be found in *Filters* → *Social Widgets* and *Filters* → *Annoyances*. It blocks popups, social media buttons, online assistant windows, and other elements on webpages that you might find annoying. |
| 42 | + |
| 43 | +*AdGuard Security* applies rules from filters under *Filters* → *Security*. This extension identifies and blocks potentially harmful elements, safeguarding users from malicious content. |
| 44 | + |
| 45 | +*AdGuard Other* applies rules from filters that don’t fall under the above-mentioned categories and that are located in *Filters* → *Other*: *Filter unblocking search ads and self-promotion*, *AdGuard DNS filter*, and *AdGuard Experimental filter*. |
| 46 | + |
| 47 | +*AdGuard Custom* applies rules from filters that you add on your own to *Custom filters*. |
| 48 | + |
| 49 | +User rules and allowlist rules are included in every extension. |
| 50 | + |
| 51 | +## AdGuard for Safari |
| 52 | + |
| 53 | +*AdGuard for Safari* activates the AdGuard icon next to the search bar. It’s useful if you want to quickly set up protection for a specific website or block ads manually. |
| 54 | + |
| 55 | +*AdGuard for Safari* extension also contains advanced rules that aren’t converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube. |
| 56 | + |
| 57 | +## How to manage Safari extensions |
| 58 | + |
| 59 | +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. |
| 60 | + |
| 61 | +  |
| 62 | + |
| 63 | +2. Click *Settings...* |
| 64 | + |
| 65 | +3. Select *Extensions*. |
| 66 | + |
| 67 | +  |
| 68 | + |
| 69 | +## Why AdGuard for Safari requires permission |
| 70 | + |
| 71 | +When enabling the *AdGuard for Safari* extension, you might notice that it requires **access to webpage content** and **access to browsing history**. Here’s why it needs these permissions: |
| 72 | + |
| 73 | +- Access to webpage content is required for manual ad blocking and advanced blocking rules to work correctly |
| 74 | +- Access to browsing history is required to check the protection status on websites and determine which advanced rules should be applied |
| 75 | + |
| 76 | +We do not use this data for any other purpose or share it with anyone. For more info, you can consult our [Privacy policy](https://adguard.com/privacy.html). |
0 commit comments