DOC-1811 Document Cloud Feature User-based throughput quotas

local-antora-playbook.yml

@@ -15,7 +15,7 @@ content:
   - url: .
     branches: HEAD
   - url: https://github.com/redpanda-data/documentation
-    branches: [main, v/*, shared, site-search]
+    branches: [v-WIP/26.1, v/*, shared, site-search]
   - url: https://github.com/redpanda-data/docs-site
     branches: [main]
     start_paths: [home]

modules/ROOT/nav.adoc

@@ -451,6 +451,7 @@
 *** xref:manage:cluster-maintenance/config-cluster.adoc[]
 *** xref:manage:audit-logging.adoc[]
 **** xref:manage:audit-logging/audit-log-samples.adoc[]
+*** xref:manage:cluster-maintenance/about-throughput-quotas.adoc[]
 *** xref:manage:cluster-maintenance/manage-throughput.adoc[]
 *** xref:manage:cluster-maintenance/configure-availability.adoc[]
 ** xref:manage:mountable-topics.adoc[]

modules/get-started/pages/whats-new-cloud.adoc

@@ -6,6 +6,15 @@
 
 This page lists new features added to Redpanda Cloud.
 
+== April 2026
+
+=== User-based throughput quotas
+
+You can now configure throughput quotas based on authenticated user principals (SASL, mTLS, or OIDC) in addition to client IDs. User-based quotas provide more precise control over resource allocation, especially in multi-tenant environments where multiple applications share the same cluster.
+
+* xref:manage:cluster-maintenance/about-throughput-quotas.adoc[About client throughput quotas]
+* xref:manage:cluster-maintenance/manage-throughput.adoc[Manage throughput]
+
 == March 2026
 
 === BYOVPC on AWS: GA

modules/manage/pages/cluster-maintenance/about-throughput-quotas.adoc

@@ -0,0 +1,7 @@
+= About Client Throughput Quotas
+:description: Understand how Redpanda's user-based and client ID-based throughput quotas work, including entity hierarchy, precedence rules, and quota tracking behavior.
+:learning-objective-1: Describe the difference between user-based and client ID-based quotas
+:learning-objective-2: Determine which quota type to use for your use case
+:learning-objective-3: Explain quota precedence rules and how Redpanda tracks quota usage
+
+include::ROOT:manage:cluster-maintenance/about-throughput-quotas.adoc[tag=single-source]

modules/manage/pages/cluster-maintenance/manage-throughput.adoc

@@ -1,4 +1,7 @@
 = Manage Throughput
-:description: Manage the throughput of Kafka traffic with configurable properties.
+:description: Configure broker-wide and client-specific throughput quotas to prevent resource exhaustion and noisy-neighbor issues.
+:learning-objective-1: Set user-based throughput quotas
+:learning-objective-2: Set client ID-based quotas
+:learning-objective-3: Monitor quota usage and throttling behavior
 
 include::ROOT:manage:cluster-maintenance/manage-throughput.adoc[tag=single-source]