EN
Review status
AdGuard Browser Extension v5.2 is here with a ton of updates that significantly enhance usability. You’ll find the full changelog below, but here are the standout features we’re most excited about.
Custom filters
You can now add your own custom filters in the MV3 extension! This feature had to take a break after our migration to MV3 because of API limitations, but it’s finally back and ready for you to use.
If there are rules that aren’t included by default but you’d like to use, simply add them right in the extension. This is powered by Chrome’s new User Scripts API, which means custom filters work a bit differently under the hood.
The User Scripts API is a set of browser-provided functions and capabilities that allow extensions to run custom JavaScript scripts on web pages. These are often used to modify or enhance websites in ways that aren’t originally provided by the website itself.
To add your own rules:
Go to Settings → Filters.
Under the Custom section, you’ll see a warning prompting you to enable Allow User Scripts. Click the link to open your browser’s extension settings.
Toggle the Allow User Scripts option to enable it.
Return to the Filters tab, open Custom, enable it using the switch in the upper-right corner.
Click Add custom filter.
With the User Scripts API, now you can also apply scripts in user rules that aren’t included in the built-in extension filters. To do this:
Go to Settings → User rules.
You’ll see a warning prompting you to enable Allow User Scripts. Click the link to open your browser’s extension settings.
Toggle the Allow User Scripts option to enable it.
Return to the User rules tab.
Click Import or write your own rule and click Save.
Update checks
In MV3, filters are now updated together with the extension itself. Until now, new filters could take a long time to reach you, because every update had to go through Chrome Web Store reviews. Recently, Chrome introduced a skip review option that significantly speeds things up.
We’ve improved our build process so that our updates are now more likely to go through this fast track, meaning you’ll get the latest filters much sooner. We also added a Check for updates button — if you don’t want to wait, you can now trigger an update check yourself with a single click.
Blocking page
We’ve redesigned the blocking pages in the MV2 extension and added them to the MV3 one. Now, when a blocking rule with the $document modifier is triggered, you’ll see a clearer, more informative warning page. Also, if you’re about to visit a potentially dangerous website, the MV2 extension now greets you with a redesigned safe browsing warning that is easier to understand and act on.
Design improvements
And finally — good news for everyone! We’ve enhanced accessibility for visually impaired users, making sure AdGuard is inclusive and easy to use for more people.
Changelog
Improvements
- Added ability to update the extension with filters manually in MV3
- Decreased time period for temporary exceptions caused by clicking Proceed anyway on a blocking page from 40 minutes to 10 seconds #3263
- Removed overflowing notification text in the options page
- Blocking page for requests blocked by
$documentrules in MV3 - Added support for Chrome’s User Scripts API that allows more reliable script injection in MV3
- Send last filter update time during issue reporting #3055
- Added ability to exit editor by pressing the Escape keyboard button #2333.
- Added сompatibility of
$headermodifier with$match-caseand$third-partymodifiers in MV2 #2942 - Added
zipandcrxartifacts for the extension builds #3163, #2488 - Restored support for custom filters thanks to the User Scripts API
- Updated blocking pages in MV2 extension for Browsing Security and for web pages blocked by
$documentrules - Improved accessibility for visually impaired users #3035, #2315, #2332
- Removed AdGuard DNS filter and AdGuard Annoyances filter as deprecated
- Increased file size limit to 10MB for
$replacerules in Firefox #3192 - Updated @adguard/dnr-rulesets to v3.2.0
- Updated @adguard/filters-downloader to v2.4.2
- Updated @adguard/assistant to v4.3.75
AGTree (A tool for working with adblock filter lists)
- Updated @adguard/agtree to v3.2.3
AdGuard Logger (A tool for logging from AdGuard extensions)
- Updated @adguard/logger to v2.0.0
Scriptlets (JavaScript enhancement for filtering rules)
- Updated @adguard/scriptlets to v2.2.10
TSUrlFilter (AdGuard Browser Extension filtering engine)
- Updated @adguard/tsurlfilter to v3.4.6
TSWebExtension (Library wrapper for Browser API and TSUrlFilter)
- Updated @adguard/tswebextension to v3.2.11
Fixes
- Cursor moves to the end when saving user rules #3145
- Cannot maximize Filtering log in Firefox for Windows #2464
- Unable to paste text into user rules input field on Android #3061
- Invalid HTML rule selectors are breaking website loading #2646, #2826
- Stealth mode’s Hide Referer from third parties option may break some websites #2839
- Filtering log: Resizing the right panel selects its contents #2305
- Types of the blocked requests are not displayed in the popup (Firefox for Android) #3157
- Switching to the Statistics tab shifts the Actions and Statistics buttons (Edge for Android) #3158
- Filtering log: Request details panel is automatically closed when loading a website in another window/tab #2327
- Scriptlet rules are not displayed in the filtering log #3164
- The filtering in Edge’s split screen doesn’t work #2832
- Total blocked popup string translated incorrectly #3204
$replacerules may break some websites #3122- Missing space in the description of AdGuard German filter in the
delocale #3216 - OOM (Out of Memory) errors may occur when applying too many patches in a row in MV2 #3230
- File size limit too low for
$replacerules in Firefox #3192 - Attributes without value are not allowed for HTML filtering rules #147
- Firefox extension doesn’t launch on browser startup #3189
- Wrong rule is displayed for pages blocked by
$documentrule in MV3 #3260 - Overflowing notification text in the options page