From 1e39014a6997155be544c711603253a04db6d3df Mon Sep 17 00:00:00 2001 From: micheleRP Date: Tue, 30 Jun 2026 21:08:13 -0600 Subject: [PATCH 1/3] DOC-14: document Cloud topic segment size default Add a Segment size row to the Cloud topic-properties table. Redpanda Cloud sets log_segment_size to 128 MiB at the cluster level, unlike self-managed Redpanda (1 GiB), and this was not documented anywhere in cloud-docs. The per-tier min/max are intentionally described as tier-dependent rather than hardcoded, pending Cloud-team confirmation. Co-Authored-By: Claude Opus 4.8 (1M context) --- modules/develop/pages/topics/create-topic.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/modules/develop/pages/topics/create-topic.adoc b/modules/develop/pages/topics/create-topic.adoc index c1c828260..efafee3a1 100644 --- a/modules/develop/pages/topics/create-topic.adoc +++ b/modules/develop/pages/topics/create-topic.adoc @@ -45,6 +45,11 @@ The default is *infinite*. | The maximum size of a message or batch for a newly-created topic. The default is *20 MiB* for BYOC and Dedicated clusters, and *8 MiB* for Serverless clusters. You can increase this value up to *32 MiB* for BYOC and Dedicated clusters, and *20 MiB* for Serverless clusters, with the `max.message.bytes` topic property. + +| *Segment size* +| The maximum size of a log segment. When a segment reaches this size, Redpanda closes it and starts a new one. + +The default is *128 MiB*, set at the cluster level. This differs from self-managed Redpanda, where the default is 1 GiB. You can override the segment size for a topic with the `segment.bytes` property, within limits that depend on your cluster tier. |=== == Next steps From 324b01a54649310dca250c9aaf6b1c1f88c718d6 Mon Sep 17 00:00:00 2001 From: micheleRP Date: Fri, 10 Jul 2026 11:32:37 -0600 Subject: [PATCH 2/3] minor edit --- modules/develop/pages/topics/create-topic.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/develop/pages/topics/create-topic.adoc b/modules/develop/pages/topics/create-topic.adoc index efafee3a1..b53e4335f 100644 --- a/modules/develop/pages/topics/create-topic.adoc +++ b/modules/develop/pages/topics/create-topic.adoc @@ -49,7 +49,7 @@ The default is *20 MiB* for BYOC and Dedicated clusters, and *8 MiB* for Serverl | *Segment size* | The maximum size of a log segment. When a segment reaches this size, Redpanda closes it and starts a new one. -The default is *128 MiB*, set at the cluster level. This differs from self-managed Redpanda, where the default is 1 GiB. You can override the segment size for a topic with the `segment.bytes` property, within limits that depend on your cluster tier. +The default is *128 MiB*, set at the cluster level. You can override the segment size for a topic with the `segment.bytes` property, within limits that depend on your cluster tier. |=== == Next steps From 50f1541aaba89da53795f2d888d51c9a1630a52c Mon Sep 17 00:00:00 2001 From: micheleRP Date: Tue, 14 Jul 2026 12:23:28 -0600 Subject: [PATCH 3/3] Clarify Cloud segment size without publishing a specific value Cloud segment size is set per cluster config profile, not the 128 MiB "cluster default" previously stated (customers never see that value). With customer scaling replacing fixed tiers, describe segment size qualitatively instead of citing a number or tier-dependent limits. Co-Authored-By: Claude Opus 4.8 (1M context) --- modules/develop/pages/topics/create-topic.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/develop/pages/topics/create-topic.adoc b/modules/develop/pages/topics/create-topic.adoc index b53e4335f..fb6a5101c 100644 --- a/modules/develop/pages/topics/create-topic.adoc +++ b/modules/develop/pages/topics/create-topic.adoc @@ -49,7 +49,7 @@ The default is *20 MiB* for BYOC and Dedicated clusters, and *8 MiB* for Serverl | *Segment size* | The maximum size of a log segment. When a segment reaches this size, Redpanda closes it and starts a new one. -The default is *128 MiB*, set at the cluster level. You can override the segment size for a topic with the `segment.bytes` property, within limits that depend on your cluster tier. +Redpanda Cloud sets the segment size for your cluster automatically. You can override it for a topic with the `segment.bytes` property. |=== == Next steps