Releases: AdguardTeam/AdguardBrowserExtension
5.3.0.8
This release strengthens the foundation of the extension, focusing on what matters most — speed, reliability, and smooth performance in the new MV3 environment.
Faster filtering engine startup
The filtering engine, known as TSUrlFilter, powers the extension, blocking unwanted content and keeping pages clean. With this update, the engine starts up twice as fast, so the extension runs smoother, and remains stable even after background restarts.
Native :has support
To block and hide page elements, the engine uses CSS selectors — a fast and reliable way to keep pages clean. Previously, :has selectors were injected by the extension itself using extended CSS. Now, where supported, the engine uses the browser’s built-in :has selector instead. This makes filtering more stable and predictable, while also reducing the load on the system.
Improved HTML filtering
A single filtering method is usually not enough on its own. When ads or other elements try to blend in with page content, HTML filtering comes in handy. It works directly with the page’s structure to detect and remove such elements. This update improves HTML filtering and brings it in line with the latest CoreLibs version, offering more accurate handling of :contains rules.
Restored csp_report blocking
Lastly, about our ongoing work with MV3. After moving to the new architecture, the blocking of csp_report requests stopped working, which could let websites collect additional data on blocked content and user activity. This update restores csp_report blocking in an MV3‑compatible way, bringing back the same level of protection and improving user privacy.
Changelog
Improvements
- Improved the readability of exported JSON files with settings by beautifying their structure #3069
- Added support for the
:has()pseudo-class as standard CSS when no other extended pseudo-classes are used in the selector, or when the#?#separator is explicitly specified #2587 - Improved readability of filter update logs and added version information before and after updates #2934
- Improved feature names and descriptions in Tracking protection (MV2)
- Improved filtering log performance by optimizing rule text retrieval
Fixes
- Repeated notifications when the dynamic rules limit is reached
- Network rules with the
$importantmodifier are applied even when protection is disabled #3227 - The Save button becomes active before the previous save operation is completed when editing User rules or Allowlist #3151
- Some requests are blocked in Inverted allowlist even when no websites are added to Allowlist #3193
- Filters are enabled after settings import when
enabled-filtersis empty
#3136 - The “Settings applied” notification appears before the settings are actually applied #3278
- The “Preserve log” option does not retain all records in the Filtering log #3148
- Tracking protection is disabled in MV3 extension when protection is paused
$documentblocking rules are applied even when a specific exception rule is present #3262- Blocked iframes are not collapsed in Firefox #3116
- The extension throws an unexpected error when accessing
[::]:8000#3360 - Toggle does not work in User rules fullscreen mode #3365
- Original rule text is displayed incorrectly in the Filtering log after rule conversion
TSUrlFilter (AdGuard Browser Extension filtering engine)
- Updated @adguard/tsurlfilter to v4.0.0
- Added full CSS selector syntax support in HTML filtering rules
#96
TSWebExtension (Library wrapper for Browser API and TSUrlFilter)
- Updated @adguard/tswebextension to v4.0.0
How to install MV3 stable:
How to install MV3 beta:
How to install MV2 stable:
5.3.0.8 beta
This release strengthens the foundation of the extension, focusing on what matters most — speed, reliability, and smooth performance in the new MV3 environment.
Faster filtering engine startup
The filtering engine, known as TSUrlFilter, powers the extension, blocking unwanted content and keeping pages clean. With this update, the engine starts up twice as fast, so the extension runs smoother, and remains stable even after background restarts.
Native :has support
To block and hide page elements, the engine uses CSS selectors — a fast and reliable way to keep pages clean. Previously, :has selectors were injected by the extension itself using extended CSS. Now, where supported, the engine uses the browser’s built-in :has selector instead. This makes filtering more stable and predictable, while also reducing the load on the system.
Improved HTML filtering
A single filtering method is usually not enough on its own. When ads or other elements try to blend in with page content, HTML filtering comes in handy. It works directly with the page’s structure to detect and remove such elements. This update improves HTML filtering and brings it in line with the latest CoreLibs version, offering more accurate handling of :contains rules.
Restored csp_report blocking
Lastly, about our ongoing work with MV3. After moving to the new architecture, the blocking of csp_report requests stopped working, which could let websites collect additional data on blocked content and user activity. This update restores csp_report blocking in an MV3‑compatible way, bringing back the same level of protection and improving user privacy.
Changelog
Improvements
- Improved the readability of exported JSON files with settings by beautifying their structure #3069
- Added support for the
:has()pseudo-class as standard CSS when no other extended pseudo-classes are used in the selector, or when the#?#separator is explicitly specified #2587 - Improved readability of filter update logs and added version information before and after updates #2934
- Improved feature names and descriptions in Tracking protection (MV2)
- Improved filtering log performance by optimizing rule text retrieval
Fixes
- Repeated notifications when the dynamic rules limit is reached
- Network rules with the
$importantmodifier are applied even when protection is disabled #3227 - The Save button becomes active before the previous save operation is completed when editing User rules or Allowlist #3151
- Some requests are blocked in Inverted allowlist even when no websites are added to Allowlist #3193
- Filters are enabled after settings import when
enabled-filtersis empty
#3136 - The “Settings applied” notification appears before the settings are actually applied #3278
- The “Preserve log” option does not retain all records in the Filtering log #3148
- Tracking protection is disabled in MV3 extension when protection is paused
$documentblocking rules are applied even when a specific exception rule is present #3262- Blocked iframes are not collapsed in Firefox #3116
- The extension throws an unexpected error when accessing
[::]:8000#3360 - Toggle does not work in User rules fullscreen mode #3365
- Original rule text is displayed incorrectly in the Filtering log after rule conversion
TSUrlFilter (AdGuard Browser Extension filtering engine)
- Updated @adguard/tsurlfilter to v4.0.0
- Added full CSS selector syntax support in HTML filtering rules
#96
TSWebExtension (Library wrapper for Browser API and TSUrlFilter)
- Updated @adguard/tswebextension to v4.0.0
How to install beta:
5.3.0.0 beta
We’ve improved the internal filtering engine, making the extension start faster and run more reliably. On average, the initialization time has been reduced by about two times. In browsers that support it, the extension now uses the :has CSS selector natively, allowing more complex elements to be filtered faster and more efficiently. We’ve also improved the format of exported and imported settings — the settings file is now cleanly structured and easy to read immediately after import.
Changelog
Improvements
- Improved readability of exported JSON file with settings by beautifying its structure #3069
- Added support for the
:has()pseudo-class as standard CSS when no other extended pseudo-classes are used in the selector, or when the#?#separator is explicitly specified #2587 - Improved readability of filter update logs and added version information before and after updates #2934
- Improved feature names and descriptions in Tracking protection (MV2)
- Improved filtering log performance by optimizing rule text retrieval
Fixes
- Repeated notifications when the dynamic rules limit is reached
- Network rules with the
$importantmodifier are applied even when protection is disabled #3227 - The Save button becomes active before the previous save operation is completed when editing User rules or Allowlist #3151
- Some requests are blocked in Inverted allowlist even when no websites are added to Allowlist #3193
- Filters are enabled after settings import when
enabled-filtersis empty
#3136 - The “Settings applied” notification appears before the settings are actually applied #3278
- The “Preserve logs” option does not retain all records in the Filtering log #3148
- Tracking protection is disabled in MV3 extension when protection is paused
$documentblocking rules are applied even when a specific exception rule is present #3262- Blocked iframes are not collapsed in Firefox #3116
- The extension throws an unexpected error when accessing
[::]:8000#3360 - Toggle does not work in User rules fullscreen mode #3365
- Original rule text is displayed incorrectly in the Filtering log after rule conversion
TSUrlFilter (AdGuard Browser Extension filtering engine)
- Updated @adguard/tsurlfilter to v4.0.0
- Added full CSS selector syntax support in HTML filtering rules
#96
TSWebExtension (Library wrapper for Browser API and TSUrlFilter)
- Updated @adguard/tswebextension to v4.0.0
How to install beta:
5.2.700.1
5.2.700.1 beta
The extension now runs more smoothly thanks to this minor update, which fixes a number of bugs.
Changelog
Fixes
- Move clipboardRead and clipboardWrite permissions to optional AND request them on User Rules Entry and Allowlist (mobile version) #3364
- The extension doesn't work in browser 360 #3058
How to install beta:
5.2.600.3
The extension now runs more smoothly thanks to this minor update, which fixes a number of bugs.
Changelog
Fixes
- Move clipboardRead and clipboardWrite permissions to optional AND request them on User Rules Entry and Allowlist (mobile version) #3364
- The extension doesn't work in browser 360 #3058
How to install MV3 stable:
How to install MV3 beta:
How to install MV2 stable:
5.2.500
5.2.500 beta
Changelog
- A small fix that addresses the issue with the Update Notification appearing intermittently #3385
How to install beta:
5.2.400
The beta version of patch 3 for AdGuard Browser Extension v5.2 brings several improvements to the app’s usability and appearance.
The most significant change is that now you can update your custom filters seamlessly with just one click. This became challenging after moving to MV3, but the function is back.
Also, we have added an animated loading icon for the extension popup, so now you can easily check if the extension is up and running.
Changelog
Improvements
- Added the possibility to update custom filters in the MV3 version of the extension #3016
- Added a new animated loading icon for the extension popup
How to install MV3 stable:
How to install MV3 beta:
How to install MV2 stable:
5.2.400 beta
The beta version of patch 3 for AdGuard Browser Extension v5.2 brings several improvements to the app’s usability and appearance.
The most significant change is that now you can update your custom filters seamlessly with just one click. This became challenging after moving to MV3, but the function is back.
Also, we have added an animated loading icon for the extension popup, so now you can easily check if the extension is up and running.
Changelog
Improvements
- Added the possibility to update custom filters in the MV3 version of the extension #3016
- Added a new animated loading icon for the extension popup