导航|地址|刷新
Create a partial zone using Terraform

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/terraform/llms.txt
Use this file to discover all available pages before exploring further.



DocsDirectoryAPISDKsChangelog

Search

Log in






Terraform

/




Overview

Get started


Tutorials


Overview

1 – Initialize Terraform

2 – Track your history

3 – Configure HTTPS settings

4 – Improve performance

5 – Add exceptions with Page Rules

6 – Revert configuration






Additional configurations


WAF Managed Rules

DDoS managed rulesets

Rate limiting rules

WAF custom rules

Transform Rules

Single Redirects ↗

Bulk Redirects ↗

Configuration Rules ↗

Origin Rules ↗

Cache Rules ↗

Snippets ↗

Workers ↗






How-to guides


Create a partial zone

Create a subdomain zone






Advanced topics


Best practices

Import Cloudflare resources

Provider customization

Remote R2 backend






Troubleshooting


Create DNS records error

Rule IDs change when making updates






Agent resources


Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Terraform llms.txt ↗

Terraform llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗













Home

/Terraform

/How-to guides

/Create a partial zone



Create a partial zone using Terraform


Last updated Apr 21, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewPrerequisitesCreate the zoneRelated resources




A partial zone lets you use Cloudflare for a subdomain while keeping your existing authoritative DNS provider for the parent domain. This guide shows how to automate the setup using the Cloudflare Terraform provider ↗.


Caution


A partial zone cannot be created in the same Cloudflare account as the parent domain's full zone.




Prerequisites


Terraform installed. Refer to Get started.

Your Cloudflare account ID and a configured provider block. Refer to Initialize Terraform.


Create the zone


Add the zone configuration and apply the change to create the zone:
resource "cloudflare_zone" "subdomain_example_com" { account = { id = var.cloudflare_account_id } name = "subdomain.example.com"}
Then, in a new Terraform plan and apply cycle, upgrade the zone to a Business plan or higher:
resource "cloudflare_zone_subscription" "example_zone_subscription" { zone_id = cloudflare_zone.subdomain_example_com.id frequency = "monthly" rate_plan = { id = "business" currency = "USD" }}
Then, again in a new Terraform plan and apply cycle, update your Terraform configuration to add type = "partial" to the zone:
resource "cloudflare_zone" "subdomain_example_com" { account = { id = var.cloudflare_account_id } name = "subdomain.example.com" type = "partial"}
Terraform places the zone in a Pending state. You must add the necessary DNS records and verify domain ownership before Cloudflare activates it.


Note


Refer to the cloudflare_zone docs ↗ in the Terraform provider documentation when you need to reference other zone properties.




Related resources


Partial zone setup

Convert a full zone to partial

cloudflare_zone resource ↗


PreviousWorkers ↗NextCreate a subdomain zone


Was this helpful?

YesNo

Edit pageReport issue




On this page

Overview

Prerequisites

Create the zone

Related resources


Edit pageReport issue














Getting started
PlansContact salesPartnersFind a partnerStartupsUnder attack?Domain name search


Company
AboutCareersInvestorsPressPress kitGlobal network




Public interest
Project GalileoAthenian ProjectCloudflare for CampaignsProject FairshotImpact/ESG


Compliance
Compliance resourcesTrust HubData ProtectionResponsible AITransparency reportReport abuse




Resources
App innovation reportCloudflare RadarCase studiesStatusSupportEventsBlog


Developers
DocumentationLearning centerCommunity




Solutions
SSE and SASE platformCloudflare AI CloudAI SecurityFrontend Development PlatformMulti-Tenant Platform DevelopmentWeb Security Platform


Start BuildingLog In












© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|
Your privacy choices








Docs




------
导航页 打开网址