> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exploratory.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose a project

A command that needs a project works on one project. Which one is decided in a fixed order.

## The order

| # | How | Example |
| - | - | - |
| 1 | `--project <id or name>` | `expl dashboard list --project "Sales Analysis"` |
| 2 | The EXPL\_PROJECT environment variable | `EXPL_PROJECT="Sales Analysis"` |
| 3 | The default set with expl project use | `expl project use "Sales Analysis"` |

The one higher in the list wins.

There are exceptions. For a command whose positional argument is project\_id, that project id takes precedence. For other commands, `--project` overrides project\_id in the `--input` JSON. Without `--project`, project\_id in the `--input` JSON is used as it is. For a command whose project is optional, EXPL\_PROJECT and the default set with expl project use are not used. expl lang also uses an open project when none of the three is set.

## Choosing by name

A name must match exactly. If several projects have the same name, expl stops with an error and lists the candidate ids. Use one of those ids.

## When the project is not open

If the project is not open in Desktop, expl returns PROJECT\_NOT\_OPEN. Open it with this command.

```sh theme={null}
expl project open <id>
```

Replace \<id> with an id from expl project list.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.