1 files changed, 40 insertions, 0 deletions
diff --git a/docs/content/en/functions/merge.md b/docs/content/en/functions/merge.md
new file mode 100644
index 000000000..cea93c53a
--- /dev/null
+++ b/docs/content/en/functions/merge.md
@@ -0,0 +1,40 @@
+---
+title: merge
+description: "`merge` deep merges two maps and returns the resulting map."
+date: 2019-08-08
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [dictionary]
+signature: ["$params :=  merge $default_params $user_params"]
+workson: []
+hugoversion: "0.56.0"
+relatedfuncs: [dict, append, reflect.IsMap, reflect.IsSlice]
+aliases: []
+---
+
+An example merging two maps.
+
+```go-html-template
+{{ $default_params := dict "color" "blue" "width" "50%" "height" "25%" }}
+{{ $user_params := dict "color" "red" "extra" (dict "duration" 2) }}
+{{ $params := merge $default_params $user_params }}
+```
+
+Resulting __$params__:
+
+```
+"color": "red"
+"extra":
+  "duration": 2
+"height": "25%"
+"icon": "mail"
+"width": "50%"
+```
+
+{{% note %}}
+  Regardless of depth, merging only applies to maps. For slices, use [append]({{< ref "functions/append" >}})
+{{% /note %}}
+
+