If you are upgrading from an earlier minor release, please refer to the Terraform v1.9 Upgrade Guide.
NEW FEATURES:
templatestring function: a new built-in function which is similar to templatefile but designed to render templates obtained dynamically, such as from a data resource result.ENHANCEMENTS:
terraform plan: Improved presentation of OPA and Sentinel policy evaluations in HCP Terraform remote runs, for logical separation.terraform init now accepts a -json option. If specified, enables the machine readable JSON output. (#34886)terraform test: Test runs can now pass sensitive values to input variables while preserving their dynamic sensitivity. Previously sensitivity would be preserved only for variables statically declared as being sensitive, using sensitive = true. (#35021)templatestring function allows rendering a template provided as a string. (#34968, #35224, #35285)resource blocks. (#35088)terraform provider: Allows moved block refactoring from the hashicorp/null provider null_resource resource type to the terraform_data resource type. (#35163)terraform output with cloud block: Terraform no longer suggests that data loss could occur when outputs are not available. (#35143)terraform console: Now has basic support for multi-line input in interactive mode. (#34822)
If an entered line contains opening parentheses/etc that are not closed, Terraform will await another line of input to complete the expression. This initial implementation is primarily intended to support pasting in multi-line expressions from elsewhere, rather than for manual multi-line editing, so the interactive editing support is currently limited.removed blocks can now declare destroy-time provisioners which will be executed when the associated resource instances are destroyed. (#35230)BUG FIXES:
remote-exec provisioner: Each remote connection will now be closed immediately after use. (#34137)terraform test: Fix bug in which non-Hashicorp providers required by testing modules and initialised within the test files were assigned incorrect registry addresses. (#35161)templatefile function no longer returns a "panic" error if the template file path is marked as sensitive. Instead, the template rendering result is also marked as sensitive. (#35180)import blocks which referenced resources in non-existent modules were silently ignored when they should have raised an error (#35330)terraform init: When selecting a version for a provider that has both positive and negative version constraints for the same prerelease -- e.g. 1.2.0-beta.1, !1.2.0-beta.1 -- the negative constraint will now overrule the positive, for consistency with how negative constraints are handled otherwise. Previously Terraform would incorrectly treat the positive as overriding the negative if the specified version was a prerelease. (#35181)import: import blocks could block a destroy operation if the target resource was already deleted (#35272)cli: plan output was missing blocks which were entirely unknown (#35271)cli: fix crash when running providers mirror with an incomplete lock file (#35322)create_before_destroy when replacing an instance, then applying with -refresh=false would order the apply operations incorrectly (#35261)resource. prefix will now be correctly parsed when used as an address target. (#35333)UPGRADE NOTES:
terraform test: It is no longer valid to specify version constraints within provider blocks within .tftest.hcl files. Instead, version constraints must be supplied within the main configuration where the provider is in use.import: Invalid import blocks pointing to nonexistent modules were mistakenly ignored in prior versions. These will need to be fixed or removed in v1.9.For information on prior major and minor releases, see their changelogs:
Fetched April 8, 2026