packer/website/content/docs/templates/hcl_templates/functions/collection/merge.mdx

---
page_title: merge function reference
description: |-
  The `merge` function returns a single map by merging the keys in multiple maps. Learn how to use the `merge` function in Packer templates.
---

⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
> [!IMPORTANT]  
> **Documentation Update:** Product documentation previously located in `/website` has moved to the [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs) repository, where all product documentation is now centralized. Please make contributions directly to `web-unified-docs`, since changes to `/website` in this repository will not appear on developer.hashicorp.com.
⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️

# `merge` Function

`merge` takes an arbitrary number of maps and returns a single map that
contains a merged set of elements from all of the maps.

If more than one given map defines the same key then the one that is later
in the argument sequence takes precedence.

## Examples

```shell-session
> merge({"a"="b", "c"="d"}, {"e"="f", "c"="z"})
{
  "a" = "b"
  "c" = "z"
  "e" = "f"
}
```