---
page_title: values function reference
description: The `values` function returns a list of the element values in a given map. Learn how to use the `values` function in Packer templates.
---

# `values` Function

`values` takes a map and returns a list containing the values of the elements
in that map.

The values are returned in lexicographical order by their corresponding _keys_,
so the values will be returned in the same order as their keys would be
returned from [`keys`](/packer/docs/templates/hcl_templates/functions/collection/keys).

## Examples

```shell-session
> values({a=3, c=2, d=1})
[
  3,
  2,
  1,
]
```

## Related Functions

- [`keys`](/packer/docs/templates/hcl_templates/functions/collection/keys) returns a list of the _keys_ from a map.
