Skip to main content

jsondecode Function

jsondecode interprets a given string as JSON, returning a representation of the result of decoding that string.

The JSON encoding is defined in RFC 7159.

This function maps JSON values to OpenTofu language values in the following way:

JSON typeOpenTofu type
Stringstring
Numbernumber
Booleanbool
Objectobject(...) with attribute types determined per this table
Arraytuple(...) with element types determined per this table
NullThe OpenTofu language null value

The OpenTofu language automatic type conversion rules mean that you don't usually need to worry about exactly what type is produced for a given value, and can just use the result in an intuitive way.

Examples

Code Block
> jsondecode("{\"hello\": \"world\"}")
{
"hello" = "world"
}
> jsondecode("true")
true
  • jsonencode performs the opposite operation, encoding a value as JSON.