---
name: "borg2-tag"
section: "1"
platform: "linux"
package: "borgbackup2"
version: "2.0.0b19-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/borg2-tag"
---

# borg2-tag(1)

Manage tags

## NAME

borg-tag - Manage tags

## SYNOPSIS

borg \[common options\] tag \[options\] \[NAME\]

## DESCRIPTION

Manage archive tags.

Borg archives can have a set of tags which can be used for matching archives.

You can set the tags to a specific set of tags or you can add or remove tags from the current set of tags.

User defined tags must not start with *@* because such tags are considered special and users are only allowed to use known special tags:

**@PROT**: protects archives against archive deletion or pruning.

Pre-existing special tags can not be removed via **--set**. You can still use **--set**, but you must give pre-existing special tags also (so they won't be removed).

## OPTIONS

See *[borg-common(1)](/borg-common/1.md)* for common options of Borg commands.

### arguments

- **NAME**

  specify the archive name

### options

- **--set** *TAG*

  set tags (can be given multiple times)

- **--add** *TAG*

  add tags (can be given multiple times)

- **--remove** *TAG*

  remove tags (can be given multiple times)

### Archive filters

- **-a** *PATTERN,* **--match-archives** *PATTERN*

  only consider archives matching all patterns. see "borg help match-archives".

- **--sort-by** *KEYS*

  Comma-separated list of sorting keys; valid keys are: timestamp, archive, name, id, tags, host, user; default is: timestamp

- **--first** *N*

  consider first N archives after other filters were applied

- **--last** *N*

  consider last N archives after other filters were applied

- **--oldest** *TIMESPAN*

  consider archives between the oldest archive's timestamp and (oldest + TIMESPAN), e.g. 7d or 12m.

- **--newest** *TIMESPAN*

  consider archives between the newest archive's timestamp and (newest - TIMESPAN), e.g. 7d or 12m.

- **--older** *TIMESPAN*

  consider archives older than (now - TIMESPAN), e.g. 7d or 12m.

- **--newer** *TIMESPAN*

  consider archives newer than (now - TIMESPAN), e.g. 7d or 12m.

## SEE ALSO

*[borg-common(1)](/borg-common/1.md)*

## AUTHOR

The Borg Collective