---
name: "glab-milestone-list"
section: "1"
platform: "linux"
package: "glab"
version: "1.126.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/glab-milestone-list"
---

# glab-milestone-list(1)

List milestones in a project or group.

## NAME

glab-milestone-list - List milestones in a project or group.

## SYNOPSIS

**glab milestone list \[flags\]**

## DESCRIPTION

Filter by state with **--state** (**active** or **closed**), by title with **--title**, or by free-text search with **--search**. For group milestones, use **--include-ancestors** to also include milestones from ancestor groups.

By default, milestones are listed for the current project. Use **--project** to target a different project, or **--group** to list group-level milestones. **--project** and **--group** are mutually exclusive.

Use **--output json** to format the result as JSON for use with other tools.

## OPTIONS

**--group**=""\
 	The ID or URL-encoded path of the group.

**--include-ancestors**\[=false\]\
 	Include milestones from all parent groups.

**--jq**=""\
 	Filter JSON output with a jq expression.

**-F**, **--output**="text"\
 	Format output as: text, json.

**-p**, **--page**=1\
 	Page number.

**-P**, **--per-page**=20\
 	Number of items to list per page.

**--project**=""\
 	The ID or URL-encoded path of the project.

**--search**=""\
 	Return only milestones with a title or description matching the provided string.

**--show-id**\[=false\]\
 	Show IDs in table output.

**--state**=""\
 	Return only 'active' or 'closed' milestones.

**--title**=""\
 	Return only the milestones having the given title.

## OPTIONS INHERITED FROM PARENT COMMANDS

**-h**, **--help**\[=false\]\
 	Show help for this command.

**-R**, **--repo**=""\
 	Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

## EXAMPLE

```
# List milestones in a project
glab milestone list --project 123
glab milestone list --project owner/project
# List milestones in a group
glab milestone list --group example-group
# List only active milestones in a group
glab milestone list --group example-group --state active
# List group milestones, including those from ancestor groups
glab milestone list --group example-group --include-ancestors
# List milestones as JSON
glab milestone list --project owner/project --output json
```

## SEE ALSO

**[glab-milestone(1)](/glab-milestone/1.md)**