From 8a5bbf949bb2bda2246f0bd04624959b07b7bcf2 Mon Sep 17 00:00:00 2001
From: Francesco Sansalvadore <f.sansalvadore@gmail.com>
Date: Fri, 28 Aug 2026 10:33:01 +0200
Subject: [PATCH] fix(storage): restore the pointer to where retention is
 configured
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The breakdown is the only place on the org usage page that tells a user how to
act on the noncurrent bytes they're being billed for, and the navigation path had
been trimmed out of it.

Also flags why the per-bucket rows aren't links: buckets are per-project and this
is an org-level page, so the endpoint needs to return a project ref before a row
can be linked — or even disambiguated, since two projects can both have an
`avatars` bucket.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .../Usage/StorageRetention/StorageRetentionBreakdown.tsx  | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/apps/studio/components/interfaces/Organization/Usage/StorageRetention/StorageRetentionBreakdown.tsx b/apps/studio/components/interfaces/Organization/Usage/StorageRetention/StorageRetentionBreakdown.tsx
index 5d9bf0ce94f..ecd8780fbeb 100644
--- a/apps/studio/components/interfaces/Organization/Usage/StorageRetention/StorageRetentionBreakdown.tsx
+++ b/apps/studio/components/interfaces/Organization/Usage/StorageRetention/StorageRetentionBreakdown.tsx
@@ -76,8 +76,14 @@ export const StorageRetentionBreakdown = () => {
               <p className="w-16 text-right text-xs">{formatBytes(bucket.noncurrent)}</p>
             </div>
           ))}
+          {/*
+           * TODO(storage-versioning): link each row to its bucket once the
+           * endpoint returns a project ref alongside the bucket name. Buckets are
+           * per-project and this is an org-level page, so today two projects with
+           * an identically named bucket are indistinguishable here.
+           */}
           <p className="pt-2 text-xs text-foreground-lighter">
-            Retention is set per bucket, in the bucket’s settings.
+            Retention is set per bucket, under Storage → bucket settings → Object versioning.
           </p>
         </div>
       )}