---
name: "git-annex-dropunused"
section: "1"
platform: "linux"
package: "git-annex"
version: "10.20261026-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-annex-dropunused"
---

# git-annex-dropunused(1)

drop unused file content

## NAME

git-annex-dropunused - drop unused file content

## SYNOPSIS

git annex dropunused **\[number\|range ...\]**

## DESCRIPTION

Drops the data corresponding to the numbers, as listed by the last **git annex unused**

You can also specify ranges of numbers, such as "1-1000". Or, specify "all" to drop all unused data.

## OPTIONS

- **--from=remote**

  -

  Rather than dropping the unused files from the local repository, drop them from the remote repository.

-

  - **--force**

  Use this option with care! It bypasses safety checks, and forces git-annex to delete the content of the specified files, even from the last repository that is storing their content. Data loss can result from using this option.

-

  - **--jobs=N** **-JN**

  Runs multiple drop jobs in parallel. This is particularly useful when git-annex has to contact remotes to check if it can drop content. For example: **-J4**

-

  Setting this to "cpus" will run one job per CPU core.

-

  - **--json**

  Enable JSON output. This is intended to be parsed by programs that use git-annex. Each line of output is a JSON object.

-

  - **--json-error-messages**

  Messages that would normally be output to standard error are included in the JSON instead.

-

  - Also the [git-annex-common-options(1)](/git-annex-common-options/1.md) can be used.

  ## SEE ALSO

[git-annex(1)](/git-annex/1.md)

[git-annex-unused(1)](/git-annex-unused/1.md)

[git-annex-drop(1)](/git-annex-drop/1.md)

[git-annex-copy(1)](/git-annex-copy/1.md)

## AUTHOR

Joey Hess \<id@joeyh.name\>