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

# plerion custom-reports

> List custom dashboards.

With **plerion custom-reports**, you can list the custom dashboards in your tenant.

<Tip>
  For more about custom dashboards in the Plerion dashboard, see [Custom dashboards](/guides/platform/custom-reports/overview). To make a dashboard the tenant's default home page, pass its ID to [`plerion tenant home-dashboard set`](/cli-reference/commands/tenant#home-dashboard-set).
</Tip>

***

## Synopsis

```bash theme={"system"}
plerion custom-reports list [options]
```

***

## Subcommands

### list

```bash theme={"system"}
plerion custom-reports list [--per-page N] [--all]
```

| Option | Type | Description |
| - | - | - |
| `--per-page` | number | Dashboards per page, from 1 to 100 (default: 50) |
| `--all` | flag | Fetch all pages automatically |

***

## Examples

```bash theme={"system"}
# List custom dashboards
plerion custom-reports list

# Fetch every dashboard as JSON
plerion custom-reports list --all --output json
```

***

## Output columns

| Column | Description |
| - | - |
| ID | Dashboard ID |
| NAME | Dashboard name |
| CREATED AT | Creation timestamp |
| UPDATED AT | Update timestamp |


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