# gel list

List matching database objects by name and type.

```cli-synopsis
gel list <type> [<options>] <pattern>
```

## Description

The `gel list` group of commands contains tools for listing database objects by matching name or type. The sub-commands are organized by the type of the objects listed.

## Types

`gel list aliases`:
Display list of aliases defined in the schema.



`gel list casts`:
Display list of casts defined in the schema.



`gel list branches`:
Display list of branches.



`gel list indexes`:
Display list of indexes defined in the schema.



`gel list modules`:
Display list of modules defined in the schema.



`gel list roles`:
Display list of roles in the server instance.



`gel list scalars`:
Display list of scalar types defined in the schema.



`gel list types`:
Display list of object types defined in the schema.



## Options

The `list` command runs in the branch it is connected to. For specifying the connection target see [connection options](https://docs.geldata.com/reference/using/cli/gel_connopts.md#ref-cli-gel-connopts).

`-c, --case-sensitive`:
Indicates that the pattern should be treated in a case-sensitive manner.



`-s, --system`:
Indicates that built-in and objects should be included in the list.



`-v, --verbose`:
Include more details in the output.



`<pattern>`:
The pattern that the name should match. If omitted all objects of a particular type will be listed.