---
name: "localsearch-tag"
section: "1"
platform: "linux"
package: "localsearch"
version: "3.12.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/localsearch-tag"
---

# localsearch-tag(1)

Add, remove and list tags.

## NAME

localsearch-tag - Add, remove and list tags.

## SYNOPSIS

```
localsearch tag FILE [-l <limit>] [-o <offset>] [-r]
localsearch tag -t [-s] [-r] FILE
localsearch tag -a <TAG> [-e <description>]
localsearch tag -d <TAG>
```

## DESCRIPTION

List tags for local files or by the tag labels themselves if -t is used.

It’s also possible to manage tags with the -a and and -d options.

The *FILE* argument can be either a local path or a URI. It also does not have to be an absolute path.

## OPTIONS

- **-t, --list**

  List all tags. Results include the number of files associated with that tag and the tag’s unique identifier. You can show the files associated with each tag by using --show-files.

- **-s, --show-files**

  Show the files associated with each tag. This option is ONLY available WITH the **--list** option.

- **-a, --add=TAG**

  Add a tag with the name *TAG*. If no *FILE* argument is specified, the tag is simply created (if it didn’talready exist) and no files are associated with it.

- **-d, --delete=TAG**

  Delete a tag with the name *TAG*. If no *FILE* argument is specified, the tag is deleted for ALL files.

- **-e, --description=STRING**

  This option ONLY applies when using **--add** and provides a description to go with the tag label according to *STRING*.

- **-l, --limit=N**

  Limit search to N results. The default is 512.

- **-o, --offset=N**

  Offset the search results by N. For example, start at item number 10 in the results. The default is 0.

```
$ localsearch tag -s -t banana
```

Should show files in the database that have both the *banana* tag.

## SEE ALSO

**localsearch search**(1), **localsearch info**(1).