---
title: List
slug: list
docTags: 
createdAt: 2021-11-30T17:53:27.000Z
---

A List of a number of objects, in order.

This datatype is often used to represent concepts such as a list of [Group](docId:7kUM4sl_wT2Y_lDfMO6qb)s, a list of [StockGrant](docId:8QnJloyOOo5jNp4x2Pucn)s, etc.

### Properties

| **Property** | **Type**                                  | **Description**                                 |
| ------------ | ----------------------------------------- | ----------------------------------------------- |
| `first`      | Object                                    | The first object in the sequence                |
| `last`       | Object                                    | The last object in the sequence                 |
| `length`     | [Number](docId\:ucI5tCTfVBhonEJ6ZQijg)    | The number of entries contained in the Sequence |
| `reversed`   | [Sequence](docId\:JG4itlQWafzLpArttFo67)  | The sequence, in reverse order                  |

### Indexing by Position

You can return each item of the list using `list[index]` syntax, starting numbering with `0` to represent the first item of the list.

- For example, `myList[2]` will return the third element in the list.

### Representing Lists

To represent a List in an expression, you can use `[square brackets]` with commas to separate the elements.

- For example: `[1, 2, 3]` will represent a List containing the numbers 1, 2, and 3.
- `["Director", "VP"]` will represent a List containing the [String](docId\:Ujw2AQAktel5uukLuP73S)s "Director" and "VP" 

### List and Equality Comparisons

The [= (equals)](docId:50o8vwTa5Zp6SV8DQdwjl) operator will test for list membership when comparing a singular value to a list.

- For example, `["Director", "VP"] = "vp"` will return true, because "VP" (case-insensitive) is a member of the list.