Terraform v5.17.0 Release

Cloudflare has released Terraform v5.17.0 for its Terraform provider, continuing the rapid development pace established since the v5 launch in January 2025. The release includes new features, significant bug fixes, and foundational work for the v4-to-v5 migration tooling.

New Features

This release introduces several new capabilities:

• AI Search Integration: New data sources for querying AI Search instances and tokens, bringing improved infrastructure-as-code support for Cloudflare's AI services
• Workers Script Enhancements:
  • Support for simple rate limit binding
  • Targeted placement mode with placement.target array for specifying placement targets (region, hostname, host)
  • New placement_mode and placement_status computed fields for better control over script deployment
• Authentication & Security: Data sources for querying authenticated origin pull certificates, hostname-specific certificates, and related settings
• Tenant Management: Support for tenant unit management with new unit field in account resources
• KV & Workers: Enhanced data sources to retrieve KV values and script content directly

Bug Fixes and Stability

The release addresses 25+ bug fixes focused on correctness and preventing state drift:

• Fixed field mapping issues across multiple resources (using correct request_id, zone_id, account_id, and entry_id fields instead of generic id)
• Improved handling of write-only fields and empty object normalization (particularly for Hyperdrive configs)
• Fixed authentication-related resources and lifecycle management
• Updated Zero Trust, pages, and DNS resources to match current API behavior

Migration Path and Stability Roadmap

Cloudflare is laying groundwork for v4-to-v5 migration with state upgraders added to 95+ resources. Most-used resources are on track to reach stable status by end of March 2026, when a dedicated migration tool will be released to help users transition from v4 with ease.