packer-cn/website/pages/docs/from-1.5/functions/collection/coalescelist.mdx

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

# `coalescelist` Function

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

## Examples

```shell-session
> 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:

```shell-session
> coalescelist([[], ["c", "d"]]...)
[
  "c",
  "d",
]
```

## Related Functions

- [`coalesce`](/docs/from-1.5/functions/collection/coalesce) performs a similar operation with string
  arguments rather than list arguments.