diff --git a/docs/general/dns-filtering-syntax.md b/docs/general/dns-filtering-syntax.md index c3b8c95ad..4c2cf8b5c 100644 --- a/docs/general/dns-filtering-syntax.md +++ b/docs/general/dns-filtering-syntax.md @@ -257,7 +257,7 @@ ANSWERS: The `dnsrewrite` response modifier allows replacing the content of the response to the DNS request for the matching hosts. Note that this modifier in AdGuard Home works in all rules, but in Private AdGuard DNS — only in custom ones. -**Rules with the `dnsrewrite` response modifier have higher priority than other rules in AdGuard Home.** +**Rules with the `dnsrewrite` response modifier have higher priority than other rules in AdGuard Home and AdGuard DNS.** Responses to all requests for a host matching a `dnsrewrite` rule will be replaced. The answer section of the replacement response will only contain RRs that match the request's query type and, possibly, CNAME RRs. Note that this means that responses to some requests may become empty (`NODATA`) if the host matches a `dnsrewrite` rule. @@ -357,6 +357,14 @@ Exception rules unblock one or all rules: - `@@||example.com^$dnsrewrite=1.2.3.4` unblocks the DNS rewrite rule that adds an `A` record with the value `1.2.3.4`. +:::info + +If you are maintaining a blocklist that is included in AdGuard DNS and AdGuard Home (i.e. included into [HostlistsRegistry][hostlistsregistry]), `$dnsrewrite` rules will be automatically filtered out. If these rules are required for your blocklist, please request permission by opening a new issue in the [HostlistsRegistry][hostlistsregistry] repo. + +::: + +[hostlistsregistry]: https://github.com/AdguardTeam/HostlistsRegistry + #### `important` {#important-modifier} The `important` modifier applied to a rule increases its priority over any other rule without the modifier. Even over basic exception rules.