Terraform Jsonencode Function Explained

Last Updated on August 7, 2025 by Arnav Sharma

Terraform, an open-source infrastructure as code software tool created by HashiCorp, enables developers to define and provision data center infrastructure using a high-level configuration language known as HCL (HashiCorp Configuration Language). Among the plethora of functions available in Terraform, jsonencode stands out for its ability to encode a given value to a JSON string. This blog dives deep into the jsonencode function, exploring its syntax, practical examples, related functions like jsondecode, and its significant role in cloud configuration and DevOps practices.

Understanding the Jsonencode Function

The jsonencode function encodes a given value (such as a string, map, or list) into a JSON format string. This function is particularly useful in Terraform for generating JSON strings dynamically from more complex Terraform data structures, making it easier to integrate Terraform with other systems that consume JSON, such as AWS IAM policies or server configuration files.

The Role of Jsonencode in Terraform for Azure

The jsonencode function in Terraform allows developers to encode a given value into a JSON string format. This capability is invaluable in Azure, where many services and configurations can be defined or deployed using JSON templates. From Azure Resource Manager (ARM) templates to configuring Azure services that accept JSON parameters, jsonencode ensures seamless integration of Terraform with Azure’s JSON-centric management model.

Azure Examples Using Jsonencode

Example 1: Creating Azure VM Custom Data

Imagine you need to deploy an Azure virtual machine with custom data for initialization. The jsonencode function can be used to encode this data into the required JSON string format.

resource "azurerm_virtual_machine" "example" {
  name                  = "example-vm"
  location              = "East US"
  resource_group_name   = azurerm_resource_group.example.name
  network_interface_ids = [azurerm_network_interface.example.id]
  vm_size               = "Standard_DS1_v2"

  storage_os_disk {
    name          = "osdisk"
    caching       = "ReadWrite"
    create_option = "FromImage"
    managed_disk_type = "Standard_LRS"
  }

  os_profile {
    computer_name  = "hostname"
    admin_username = "testadmin"
    admin_password = "Password1234!"
    custom_data    = jsonencode({
      "cloud-init" = "#cloud-confignpackages:n - nginxn - nodejsn - npm"
    })
  }

  os_profile_linux_config {
    disable_password_authentication = false
  }
}

In this scenario, jsonencode is used to encode the custom data script into a JSON string, which is then passed to the Azure VM as its custom data parameter for initialization.

Example 2: Integrating Azure Functions with Terraform Using Jsonencode

For a more complex example, consider an Azure Function that requires a specific configuration passed as an application setting in JSON format.

resource "azurerm_function_app" "example" {
  name                       = "example-functionapp"
  location                   = azurerm_resource_group.example.location
  resource_group_name        = azurerm_resource_group.example.name
  app_service_plan_id        = azurerm_app_service_plan.example.id
  storage_connection_string  = azurerm_storage_account.example.primary_connection_string

  app_settings = {
    "FUNCTIONS_WORKER_RUNTIME" = "dotnet"
    "settings"                 = jsonencode({
      "Key1" = "Value1",
      "Key2" = "Value2",
      "NestedSettings" = {
        "NestedKey1" = "NestedValue1"
      }
    })
  }
}

By using jsonencode, complex configurations can be dynamically generated and incorporated into Azure resources, ensuring flexibility and adaptability of the infrastructure as code.

Leveraging Jsondecode and Related Functions

To complement jsonencode, the jsondecode function decodes JSON-formatted strings back into Terraform data structures, perfect for scenarios where you’re working with existing JSON data or configurations that need to be imported or parsed within Terraform.

Decoding Configuration Data for Azure Resources

If you have JSON data representing Azure resource configurations, jsondecode can transform this JSON into a Terraform-readable format, enabling further manipulation or conditionals based on the configuration’s contents.

---