---
layout: commands
page_title: 'Commands: Artifact list'
sidebar_title: 'artifact list'
description: 'List pushed artifacts.'
---

# Waypoint Artifact list

Command: `waypoint artifact list`

List pushed artifacts.

@include "commands/artifact-list_desc.mdx"

## Usage

Usage: `waypoint artifact list [options]`

Lists the artifacts that are pushed to a registry. This does not
list the artifacts that are just part of local builds.

#### Global Options

- `-plain` - Plain output: no colors, no animation. The default is false.
- `-app=<string>` (`-a`) - App to target. Certain commands require a single app target for Waypoint configurations with multiple apps. If you have a single app, then this can be ignored.
- `-project=<string>` (`-p`) - Project to target.
- `-workspace=<string>` (`-w`) - Workspace to operate in.

#### Command Options

- `-workspace-all` - List builds in all workspaces for this project and application. The default is false.
- `-verbose` (`-V`) - Display more details about each deployment. The default is false.
- `-json` - Output the deployment information as JSON. The default is false.
- `-long-ids` - Show long identifiers rather than sequence numbers. The default is false.

#### Filter Options

- `-order-by=<string>` - Order the values by which field. One possible value from: start-time, complete-time.
- `-desc` - Sort the values in descending order. The default is false.
- `-limit=<uint>` - How many values to show.

@include "commands/artifact-list_more.mdx"
