Skip to content

Commit 9e3918d

Browse files
Remove remaining descr from previous version and add examples
1 parent 58e1b0d commit 9e3918d

File tree

1 file changed

+24
-8
lines changed

1 file changed

+24
-8
lines changed

src/content/docs/dns/manage-dns-records/reference/wildcard-dns-records.mdx

Lines changed: 24 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -56,23 +56,37 @@ If you create a DNS record on `*.*.example.com`, only the first asterisk is inte
5656

5757
A wildcard record applies only when no exact record exists at the queried name. If a record or delegation exists, the wildcard does not apply.
5858

59-
Wildcards will be applied for multiple levels, but a specific record on any equal or lower level will terminate anything on or below this specific record.
59+
<Details header="Example 1 - specific or below">
6060

61-
<Details header="Example">
62-
63-
If you have only these two records on your domain, `A` and `TXT`:
61+
If you have only these two records on your domain:
6462

6563
| Type | Name | Content |
6664
| ----- | ------------------------- | ------------- |
67-
| `A` | `*.example.com` | `192.0.2.3` |
68-
| `TXT` | `subdomain1.example.com ` | `<some_text>` |
65+
| `A` | `*` | `192.0.2.1` |
66+
| `TXT` | `abc` | `<some_text>` |
6967

70-
The `A` wildcard record will be used for queries going to any subdomain of `example.com` except `subdomain1.example.com` or anything below that specific label (`deeper.label.subdomain1.example.com`).
68+
The `A` wildcard record will be used for queries going to any subdomain of `example.com` except `abc.example.com` or anything below that specific label (`123.abc.example.com` or `deeper.label.abc.example.com`, and so on).
7169

72-
The wildcard will still be used for deeper labels that are not below the specific record on `subdomain1.example.com` — for example, `deeper.label.subdomain2.example.com`.
70+
The wildcard will still be used for deeper labels that are not below the specific record on `abc.example.com` — for example, `deeper.label.xyz.example.com`.
7371

7472
</Details>
7573

74+
<Details header="Example 2 - implicit parent">
75+
76+
If you have only these two records on your domain:
77+
78+
| Type | Name | Content |
79+
| ----- | ------------------------- | ------------- |
80+
| `A` | `*` | `192.0.2.1` |
81+
| `TXT` | `123.abc` | `<some_text>` |
82+
83+
In this example, `123.abc.example.com` is a descendant of `abc.example.com`, and `abc.example.com` has no records associated with it. The behavior will depend on the type of nameservers you are using:
84+
85+
- Standard nameservers: The wildcard `*.example.com` will still apply to `abc.example.com`.
86+
- [Advanced nameservers](dns/foundation-dns/setup/)[^1]: In compliance with [RFC 4592](https://www.rfc-editor.org/rfc/rfc4592.html), the wildcard `*.example.com` will not apply to `abc.example.com`.
87+
88+
</Details>
89+
7690
## Availability
7791

7892
Customers on all plans can create and proxy wildcard DNS records.
@@ -86,3 +100,5 @@ If you are using a [partial (CNAME) setup](/dns/zone-setups/partial-setup/) for
86100
## Additional information
87101

88102
For more information on wildcard records — as well as more details about their limitations — refer to the [introductory blog post](https://blog.cloudflare.com/wildcard-proxy-for-everyone/).
103+
104+
[^1]: An opt-in configuration available for Enterprise customers.

0 commit comments

Comments
 (0)