---
name: "hg-phase"
section: "1"
platform: "linux"
package: "mercurial"
version: "7.2.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/hg-phase"
---

# hg-phase(1)

set or show the current phase name

## NAME

hg phase - set or show the current phase name

## SYNOPSIS

```
hg phase [-p|-d|-s] [-f] [-r] [REV...]
```

## DESCRIPTION

With no argument, show the phase name of the current revision(s).

With one of -p/--public, -d/--draft or -s/--secret, change the phase value of the specified revisions.

Unless -f/--force is specified, **hg phase** won't move changesets from a lower phase to a higher phase. Phases are ordered as follows:

```
public < draft < secret
```

Returns 0 on success, 1 if some phases could not be changed.

(For more information about the phases concept, see **hg help phases**.)

## OPTIONS

- **-p, --public**

  set changeset phase to public

- **-d, --draft**

  set changeset phase to draft

- **-s, --secret**

  set changeset phase to secret

- **-f, --force**

  allow to move boundary backward

- **-r,***--rev* **\<REV\[+\]\>**

  target revision

  \[+\] marked option can be specified multiple times