layout	page_title	sidebar_current	description
functions	coalescelist - Functions - Configuration Language	docs-funcs-collection-coalescelist	The coalescelist function takes any number of list arguments and returns the first one that isn't empty.

`coalescelist` Function

-> Note: This page is about Terraform 0.12 and later. For Terraform 0.11 and earlier, see 0.11 Configuration Language: Interpolation Syntax.

coalescelist takes any number of list arguments and returns the first one that isn't empty.

Examples

> coalescelist(["a", "b"], ["c", "d"])
[
  "a",
  "b",
]
> coalescelist([], ["c", "d"])
[
  "c",
  "d",
]

To perform the coalescelist operation with a list of lists, use the ... symbol to expand the outer list as arguments:

> coalescelist([[], ["c", "d"]]...)
[
  "c",
  "d",
]

coalesce performs a similar operation with string arguments rather than list arguments.