---
name: "hg-bookmarks"
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-bookmarks"
---

# hg-bookmarks(1)

create a new bookmark or list existing bookmarks

## NAME

hg bookmarks - create a new bookmark or list existing bookmarks

## SYNOPSIS

```
hg bookmarks [OPTIONS]... [NAME]...
```

## DESCRIPTION

Bookmarks are labels on changesets to help track lines of development. Bookmarks are unversioned and can be moved, renamed and deleted. Deleting or moving a bookmark has no effect on the associated changesets.

Creating or updating to a bookmark causes it to be marked as 'active'. The active bookmark is indicated with a '\*'. When a commit is made, the active bookmark will advance to the new commit. A plain **hg update** will also advance an active bookmark, if possible. Updating away from a bookmark will cause it to be deactivated.

Bookmarks can be pushed and pulled between repositories (see **hg help push** and **hg help pull**). If a shared bookmark has diverged, a new 'divergent bookmark' of the form 'name@path' will be created. Using **hg merge** will resolve the divergence.

Specifying bookmark as '.' to -m/-d/-l options is equivalent to specifying the active bookmark's name.

A bookmark named '@' has the special property that **hg clone** will check it out by default if it exists.

Template:

The following keywords are supported in addition to the common template keywords and functions such as **{bookmark}**. See also **hg help templates**.

- **active**

  Boolean. True if the bookmark is active.

  Examples:

- •

  create an active bookmark for a new line of development:

  ```
  hg book new-feature
  ```

- •

  create an inactive bookmark as a place marker:

  ```
  hg book -i reviewed
  ```

- •

  create an inactive bookmark on another changeset:

  ```
  hg book -r .^ tested
  ```

- •

  rename bookmark turkey to dinner:

  ```
  hg book -m turkey dinner
  ```

- •

  move the '@' bookmark from another branch:

  ```
  hg book -f @
  ```

- •

  print only the active bookmark name:

  ```
  hg book -ql .
  ```

## OPTIONS

- **-f, --force**

  force

- **-r,***--rev* **\<REV\>**

  revision for bookmark action

- **-d, --delete**

  delete a given bookmark

- **-m,***--rename* **\<OLD\>**

  rename a given bookmark

- **-i, --inactive**

  mark a bookmark inactive

- **-l, --list**

  list existing bookmarks

- **-T,***--template* **\<TEMPLATE\>**

  display with template

## ALIASES

```
bookmark
```