Domains and IP Ranges
Last edited on 28 Jan 2026
When writing examples, tutorials, or configuration snippets, use only domains and IP address ranges that are explicitly reserved for documentation purposes. This guidance follows IANA allocations and the relevant RFCs for example domains and IP addresses.
Using reserved examples ensures documentation is safe, non-routable, and cannot interfere with real networks, customer environments, or production systems.
General Principles
When including domains or IP addresses in documentation:
- Use only RFC-designated example domains and address ranges.
- Never use real, customer, private, or public IP addresses.
- Ensure example resources are non-routable and non-functional.
- Do not turn example domains into clickable links.
Reserved Domains and IP Ranges
Use the following domains and IP ranges when examples require them.
| Type | Example | RFC |
|---|---|---|
| IPv4 (documentation use) | 192.0.2.0/24198.51.100.0/24203.0.113.0/24 |
RFC 5737 |
| IPv6 (documentation use) | 2001:DB8::/32 |
RFC 3849 |
| Domain names | example.comexample.netexample.orgexample.edu |
RFC 2606 |
Domain Usage
Use reserved example domains defined in RFC 2606:
example.comexample.netexample.orgexample.edu
These domains are guaranteed not to host real content. Use them only in text or code examples, and do not link to them.