Channels

Channels are named release tracks within a project. Common channel names include production, staging, and dev, but you can create any name that fits your workflow.

A channel doesn't contain deployments — it points at them. For each version the channel serves, one pointer selects the live revision. Publishing creates or moves a pointer; unpublishing removes it. The deployments themselves are shared, immutable, and untouched by any channel operation. See Deployments for the publish and unpublish commands.

List Channels

$ xc cloud channel list [options]

Option	Abbr	Description
`--workspace`	`-w`	Workspace to query
`--project`	`-p`	Project to query (defaults to current project)

Displays a table with columns: Channel, Created At, Updated At.

Delete a Channel

Delete a channel and its pointers:

$ xc cloud channel delete <channel> [options]

Argument	Required	Description
`<channel>`	Yes	Channel name to delete

Option	Abbr	Description
`--workspace`	`-w`	Workspace to use
`--project`	`-p`	Project to use

Deleting a channel unpublishes everything it serves, but does not delete any deployments — they remain in the project and can be published to other channels.

The CLI prompts for confirmation before deleting.

Warning

Client apps configured with this channel will stop receiving updates and fall back to their cached or embedded resources. This action cannot be undone.

Rename a Channel

$ xc cloud channel rename <name> [new-name] [options]

Argument	Required	Description
`<name>`	Yes	Current channel name
`[new-name]`	No	New name (prompted if not provided)

Option	Abbr	Description
`--workspace`	`-w`	Workspace to use
`--project`	`-p`	Project to use

Naming Rules

Channel names must:

Be 30 characters or less
Contain only letters, numbers, hyphens, and underscores
Not be local — it's reserved for bundles shipped inside the app

Warning

If the channel is serving deployments, the CLI warns that renaming may cause client apps referencing the old name to stop receiving updates and reporting analytics. Update your apps as soon as possible after renaming.