Error AtlasError Documentation and Resolution
Back to search

Terraform CLI

Terraform could not find the referenced local value

Error: Reference to undeclared local value

Terraform could not evaluate the expression because the referenced local value was never declared in the current module.

Reference to undeclared local valueconfiguration

Observed message

Error: Reference to undeclared local value

Why it happens

  • The local value name is misspelled or was renamed.
  • The local was never declared in the current module.
  • The configuration references a local where a variable, output, or resource attribute should be used instead.

How to fix it

  1. Check the local name for typos and confirm it exists in a locals block in the same module.
  2. Add the missing local definition if it should exist.
  3. Replace the reference with the correct variable, output, or resource value if a local is not the right construct.

Official reference

try function reference

Related errors

no Terraform configuration filesTerraform command ran without configuration files in the working directoryUnsupported argumentTerraform configuration contains an unsupported argumentMissing required argumentTerraform configuration is missing a required argumentInvalid function argumentTerraform could not convert the value to bool

Explore more

configurationBrowse more configuration errors
Terraform Reference to undeclared local value: causes and fixes | Error Atlas