# rpk topic describe-storage

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: rpk topic describe-storage
latest-redpanda-tag: v26.1.14
latest-console-tag: v3.10.0
latest-operator-version: v26.2.1
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "false"
page-eol-date: March 31, 2027
latest-connect-version: 4.104.0
docname: rpk/rpk-topic/rpk-topic-describe-storage
page-component-name: streaming
page-version: "26.1"
page-component-version: "26.1"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-topic/rpk-topic-describe-storage.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/v/26.1/modules/reference/pages/rpk/rpk-topic/rpk-topic-describe-storage.adoc
description: Describe the cloud storage status of a topic, including storage mode, offset availability, segment sizes, and synchronization state.
page-git-created-date: "2023-08-04"
page-git-modified-date: "2026-07-17"
support-status: supported
---

<!-- Source: https://docs.redpanda.com/streaming/26.1/reference/rpk/rpk-topic/rpk-topic-describe-storage.md -->

Describe the cloud storage status of a topic, including storage mode, offset availability, segment sizes, and synchronization state.

## [](#usage)Usage

```bash
rpk topic describe-storage <topic> [flags]
```

### [](#summary)Summary

The summary section contains general information about the topic, the cloud storage mode (one of disabled, write\_only, read\_only, full, read\_replica, cloud\_topic, and cloud\_topic\_read\_replica), and the delta in milliseconds since the last upload of either the partition manifest or a segment.

### [](#offset)Offset

The offset section contains the start and last offsets (`inclusive`) per partition of data available in both the cloud and on local disk.

### [](#size)Size

For tiered storage topics, the size section contains the total bytes per partition in the cloud and on local disk, the total size of the log of each partition (excluding cloud and local overlap), and the number of segments in the cloud and on local disk. The cloud segment count does not include segments queued for deletion.

For cloud topics, the size section shows the L0 (level zero) and L1 (level one) byte breakdown, the total bytes, and the number of L1 extents.

### [](#sync)Sync

The sync section contains the state of cloud synchronization: milliseconds since the last upload of the partition manifest, milliseconds since the last segment upload, milliseconds since the last manifest sync (for read replicas), and whether the remote metadata has a pending update to include all uploaded segments.

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| -H, --human-readable | bool | Print times (in milliseconds) and byte values in human-readable units (for example, 1.2 GiB, 3m 20s). |
| -a, --print-all | bool | Print all cloud storage status. |
| -o, --print-offset | bool | Print the offset section. |
| -z, --print-size | bool | Print the log size section. |
| -s, --print-summary | bool | Print the summary section. |
| -y, --print-sync | bool | Print the sync section. |

## [](#global-flags)Global flags

| Value | Type | Description |
| --- | --- | --- |
| --config | string | Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings; -X help for detail or -X list for terser detail. |
| --ignore-profile | bool | Ignore rpk.yaml and redpanda.yaml; use default settings. |
| --profile | string | rpk profile to use. |
| -v, --verbose | bool | Enable verbose logging. |