Skip to main content
Terragrunt’s built-in function find_in_parent_folders enables recursive searches up your directory tree to locate a specific file or folder. This approach is invaluable when you need to reference shared configurations or modules in a multi-layered project, removing the brittleness of hardcoded relative paths.
The image shows a hierarchical arrangement of folder icons with the label "find_in_parent_folders" at the top and "Functionality" at the bottom. It appears to represent a file system structure or search functionality within parent folders.

​
Why Use find_in_parent_folders?

By leveraging this function, you can:
  • Dynamically adapt configuration based on files located higher in the hierarchy
  • Inherit and override settings across environments without manual path tweaks
  • Maintain cleaner, DRY (Don’t Repeat Yourself) configurations
The image is a presentation slide titled "find_in_parent_folders," highlighting two benefits: adapting based on configurations from parent folders and flexible configuration inheritance.

​
Best Practices

  • Organize projects into clear, modular, hierarchical folders
  • Use find_in_parent_folders inside include blocks to locate root-level terragrunt.hcl
  • Avoid embedding static paths; let Terragrunt resolve them dynamically
The image is a diagram titled "find_in_parent_folders" with icons and text explaining its use in modular environments and include blocks, along with a "Best Practices" button.
find_in_parent_folders stops when it hits the filesystem root or finds the target file. If the file isn’t present, Terragrunt throws an error.

​
Real-World Example

Imagine a VPC module that relies on common variables from common.hcl. Before (hardcoded path):
After (dynamic lookup):
Now, no matter how deep your vpc/ folder is nested, Terragrunt will climb up until it finds common.hcl.

​
Verify with Terragrunt

Run:
You should see the VPC name generated using values from common.hcl, for example:

​
common.hcl

​
References

Watch Video