hugo/docs/content/en/functions/dict.md

title	description	godocref	workson	date	publishdate	lastmod	categories	menu	keywords	signature	workson	hugoversion	relatedfuncs	deprecated	aliases
dict	Creates a dictionary from a list of key and value pairs.			2017-02-01	2017-02-01	2017-02-26	functions	docs parent functions	dictionary	dict KEY VALUE [KEY VALUE]...				false

---

title: dict description: Creates a dictionary from a list of key and value pairs. godocref: workson: [] date: 2017-02-01 publishdate: 2017-02-01 lastmod: 2017-02-26 categories: [functions] menu: docs: parent: "functions" keywords: [dictionary] signature: ["dict KEY VALUE [KEY VALUE]..."] workson: [] hugoversion: relatedfuncs: [] deprecated: false aliases: []

dict is especially useful for passing more than one value to a partial template.

Note that the key can be either a string or a string slice. The latter is useful to create a deply nested structure, e.g.:

{{ $m := dict (slice "a" "b" "c") "value" }}

Example: Using dict to pass multiple values to a partial

The partial below creates a SVG and expects fill, height and width from the caller:

Partial definition

{{< code file="layouts/partials/svgs/external-links.svg" download="external-links.svg" >}} {{< /code >}}

Partial call

The fill, height and width values can be stored in one object with dict and passed to the partial:

{{< code file="layouts/_default/list.html" >}} {{ partial "svgs/external-links.svg" (dict "fill" "#01589B" "width" 10 "height" 20 ) }} {{< /code >}}