packer/website/pages/docs/from-1.5/functions/collection/index-fn.mdx

---
layout: docs
page_title: index - Functions - Configuration Language
sidebar_title: index
description: The index function finds the element index for a given value in a list.
---

# `index` Function

`index` finds the element index for a given value in a list.

```hcl
index(list, value)
```

The returned index is zero-based. This function produces an error if the given
value is not present in the list.

## Examples

```shell
> index(["a", "b", "c"], "b")
1
```

## Related Functions

- [`element`](/docs/from-1.5/functions/collection/element) retrieves a particular element from a list given
  its index.