terraform/website/docs/configuration/functions/list.html.md

---
layout: "functions"
page_title: "list - Functions - Configuration Language"
sidebar_current: "docs-funcs-collection-list"
description: |-
  The list function constructs a list from some given elements.
---

# `list` Function

-> **Note:** This page is about Terraform 0.12 and later. For Terraform 0.11 and
earlier, see
[0.11 Configuration Language: Interpolation Syntax](../../configuration-0-11/interpolation.html).

~> **This function is deprecated.** From Terraform v0.12, the Terraform
language has built-in syntax for creating lists using the `[` and `]`
delimiters. Use the built-in syntax instead. The `list` function will be
removed in a future version of Terraform.

`list` takes an arbitrary number of arguments and returns a list containing
those values in the same order.

## Examples

```
> list("a", "b", "c")
[
  "a",
  "b",
  "c",
]
```

Do not use the above form in Terraform v0.12 or above. Instead, use the
built-in list construction syntax, which achieves the same result:

```
> ["a", "b", "c"]
[
  "a",
  "b",
  "c",
]
```

## Related Functions

* [`tolist`](./tolist.html) converts a set value to a list.