Manage internal zones
Refer to the following sections to learn how to manage your internal DNS zones.
When setting up internal zones, observe the following conditions:
- Internal zones can contain the same DNS record types that Cloudflare supports for public zones.
- An internal zone can have the same name as a public zone in the same account.
- Each internal zone can be linked to multiple views1.
- There can be several internal zones with the same name in one account. However, two internal zones with the same name cannot be linked to the same view.
- Internal zones are not subject to any top-level domain (TLD) restrictions. This means that an internal zone can be created if its TLD is not registered publicly (for example,
xyz.local
), if it is created on the TLD itself (local
), or even if on the root (.
).
-
Logical groupings of internal DNS zones that are referenced by Gateway resolver policies to define how a specific query should be resolved. ↩
- Log in to the Cloudflare dashboard ↗ and select your account.
- Go to Internal DNS and select Create an internal zone.
- Give your internal zone a name.
- Add DNS records to your internal zone using your preferred option:
- Import a formatted BIND file.
- Select Add a record and choose Create under the record type you want to add. Refer to DNS record types for details.
- Repeat this process for each internal zone you wish to add.
- Use the Create Zone endpoint to create an internal zone. Specify your account ID and set the
type
tointernal
.
- Add DNS records to your internal zone using your preferred option:
- Import a formatted BIND file. Refer to the DNS records how-to for guidance.
- Use other API endpoints, such as
/batch
, to manage DNS records. Refer to Batch record changes for details.
- Repeat this process for each internal zone you wish to add.
The API endpoints to manage internal zones are the same as for managing public zones. The main difference is that the zone type must be set to internal
. Refer to the API documentation below for details:
- Update an internal zone (
PATCH
) - Get internal zone details (
GET
) - List internal zones (
GET
) - Delete an internal zone (
DELETE
)
Was this helpful?
- Resources
- API
- New to Cloudflare?
- Products
- Sponsorships
- Open Source
- Support
- Help Center
- System Status
- Compliance
- GDPR
- Company
- cloudflare.com
- Our team
- Careers
- 2025 Cloudflare, Inc.
- Privacy Policy
- Terms of Use
- Report Security Issues
- Trademark
-