rclone/docs/content/commands/rclone_size.md

---
title: "rclone size"
description: "Prints the total size and number of objects in remote:path."
slug: rclone_size
url: /commands/rclone_size/
versionIntroduced: v1.23
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/size/ and as part of making a release run "make commanddocs"
---
# rclone size

Prints the total size and number of objects in remote:path.

## Synopsis


Counts objects in the path and calculates the total size. Prints the
result to standard output.

By default the output is in human-readable format, but shows values in
both human-readable format as well as the raw numbers (global option
`--human-readable` is not considered). Use option `--json`
to format output as JSON instead.

Recurses by default, use `--max-depth 1` to stop the
recursion.

Some backends do not always provide file sizes, see for example
[Google Photos](/googlephotos/#size) and
[Google Docs](/drive/#limitations-of-google-docs).
Rclone will then show a notice in the log indicating how many such
files were encountered, and count them in as empty files in the output
of the size command.


```
rclone size remote:path [flags]
```

## Options

```
  -h, --help   help for size
      --json   Format output as JSON
```

See the [global flags page](/flags/) for global options not listed here.

## SEE ALSO

* [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md 2016-08-03 22:36:28 +02:00			`---`
			`title: "rclone size"`
docs: add description to commands and index page 2020-05-16 16:11:55 +02:00			`description: "Prints the total size and number of objects in remote:path."`
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md 2016-08-03 22:36:28 +02:00			`slug: rclone_size`
			`url: /commands/rclone_size/`
Version v1.61.0 2022-12-20 18:16:14 +01:00			`versionIntroduced: v1.23`
gendocs: add autogenerated header to all docs 2020-02-10 13:31:45 +01:00			`# autogenerated - DO NOT EDIT, instead edit the source code in cmd/size/ and as part of making a release run "make commanddocs"`
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md 2016-08-03 22:36:28 +02:00			`---`
docs: make command docs titles be one higher 2020-05-22 12:17:37 +02:00			`# rclone size`
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md 2016-08-03 22:36:28 +02:00
			`Prints the total size and number of objects in remote:path.`

Version v1.59.0 2022-07-09 19:08:20 +02:00			`## Synopsis`


			`Counts objects in the path and calculates the total size. Prints the`
			`result to standard output.`

			`By default the output is in human-readable format, but shows values in`
			`both human-readable format as well as the raw numbers (global option`
			`--human-readable` is not considered). Use option `--json`
			`to format output as JSON instead.`

			Recurses by default, use `--max-depth 1` to stop the
			`recursion.`

			`Some backends do not always provide file sizes, see for example`
			`[Google Photos](/googlephotos/#size) and`
Version v1.63.0 2023-06-30 15:11:17 +02:00			`[Google Docs](/drive/#limitations-of-google-docs).`
Version v1.59.0 2022-07-09 19:08:20 +02:00			`Rclone will then show a notice in the log indicating how many such`
			`files were encountered, and count them in as empty files in the output`
			`of the size command.`


Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md 2016-08-03 22:36:28 +02:00			```
Version v1.38 2017-09-30 15:19:47 +02:00			`rclone size remote:path [flags]`
			```

docs: make command docs titles be one higher 2020-05-22 12:17:37 +02:00			`## Options`
Version v1.38 2017-09-30 15:19:47 +02:00
			```
			`-h, --help help for size`
Version v1.57.0 2021-11-01 16:42:05 +01:00			`--json Format output as JSON`
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md 2016-08-03 22:36:28 +02:00			```

docs: add a new page with global flags and link to it from the command docs In f544234 we removed the global flags from each command as it was making each page very big and causing 1000s of lines of duplication in the man page. This change adds a new flags page with all the global flags on and links each command page to it. Fixes #3273 2019-06-20 17:18:02 +02:00			`See the [global flags page](/flags/) for global options not listed here.`

docs: make command docs titles be one higher 2020-05-22 12:17:37 +02:00			`## SEE ALSO`
Use cobra autogenerated docs * put the most up to date docs into the code * generate command docs using rclone gendocs * put command docs into own directory * remake them into MANUAL.md 2016-08-03 22:36:28 +02:00
Version v1.44 2018-10-15 12:03:08 +02:00			`* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.`
Version v1.40 2018-03-19 11:06:13 +01:00