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

# hg-rename(1)

rename files; equivalent of copy + remove

## NAME

hg rename - rename files; equivalent of copy + remove

## SYNOPSIS

```
hg rename [OPTION]... SOURCE... DEST
```

## DESCRIPTION

Mark dest as copies of sources; mark sources for deletion. If dest is a directory, copies are put in that directory. If dest is a file, there can only be one source.

By default, this command copies the contents of files as they exist in the working directory. If invoked with -A/--after, the operation is recorded, but no copying is performed.

To undo marking a destination file as renamed, use --forget. With that option, all given (positional) arguments are unmarked as renames. The destination file(s) will be left in place (still tracked). The source file(s) will not be restored. Note that **hg rename --forget** behaves the same way as **hg copy --forget**.

This command takes effect with the next commit by default.

Returns 0 on success, 1 if errors are encountered.

## OPTIONS

- **--forget**

  unmark a destination file as renamed

- **-A, --after**

  record a rename that has already occurred

- **--at-rev** *\<REV\>*

  (un)mark renames in the given revision (EXPERIMENTAL)

- **-f, --force**

  forcibly move over an existing managed file

- **-I,***--include* **\<PATTERN\[+\]\>**

  include names matching the given patterns

- **-X,***--exclude* **\<PATTERN\[+\]\>**

  exclude names matching the given patterns

- **-n, --dry-run**

  do not perform actions, just print output

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

## ALIASES

```
move, mv
```