From 37500328a214a0972ccd0fdccb26f79f7d968704 Mon Sep 17 00:00:00 2001
From: Jordi Enric <37541088+jordienr@users.noreply.github.com>
Date: Thu, 23 Oct 2025 15:22:06 +0200
Subject: [PATCH] Rename Active Users to Auth Activity  (#39805)

rename active users to auth activity
---
 .../Auth/Overview/OverviewUsage.tsx           | 33 ++++++++++++++++---
 .../data/reports/v2/auth-report.test.tsx      |  6 ++--
 apps/studio/data/reports/v2/auth.config.ts    |  7 ++--
 3 files changed, 36 insertions(+), 10 deletions(-)

diff --git a/apps/studio/components/interfaces/Auth/Overview/OverviewUsage.tsx b/apps/studio/components/interfaces/Auth/Overview/OverviewUsage.tsx
index da2b2a5e80a..0ba0062ea14 100644
--- a/apps/studio/components/interfaces/Auth/Overview/OverviewUsage.tsx
+++ b/apps/studio/components/interfaces/Auth/Overview/OverviewUsage.tsx
@@ -3,10 +3,20 @@ import {
   ScaffoldSectionTitle,
   ScaffoldSectionContent,
 } from 'components/layouts/Scaffold'
-import { Card, CardContent, CardHeader, CardTitle, cn, Skeleton } from 'ui'
+import {
+  Card,
+  CardContent,
+  CardHeader,
+  CardTitle,
+  cn,
+  Skeleton,
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from 'ui'
 import Link from 'next/link'
 import { useParams } from 'common'
-import { ChevronRight, ExternalLink } from 'lucide-react'
+import { ChevronRight, ExternalLink, HelpCircle } from 'lucide-react'
 import { Reports } from 'icons'
 import {
   getChangeColor,
@@ -28,6 +38,7 @@ export const StatCard = ({
   suffix = '',
   invert = false,
   href,
+  tooltip,
 }: {
   title: string
   current: number
@@ -36,6 +47,7 @@ export const StatCard = ({
   suffix?: string
   invert?: boolean
   href?: string
+  tooltip?: string
 }) => {
   const router = useRouter()
   const isZeroChange = previous === 0
@@ -53,7 +65,19 @@ export const StatCard = ({
   return (
     <Card className={cn(href, 'mb-0 flex flex-col')}>
       <CardHeader className="flex flex-row items-center justify-between gap-2 space-y-0 pb-0 border-b-0 relative">
-        <CardTitle className="text-foreground-light">{title}</CardTitle>
+        <CardTitle className="text-foreground-light flex items-center gap-2">
+          {title}
+          {tooltip && (
+            <Tooltip>
+              <TooltipTrigger>
+                <HelpCircle className="text-foreground-light" size={14} strokeWidth={1.5} />
+              </TooltipTrigger>
+              <TooltipContent className="w-[300px]">
+                <p>{tooltip}</p>
+              </TooltipContent>
+            </Tooltip>
+          )}
+        </CardTitle>
         <ButtonTooltip
           type="text"
           size="tiny"
@@ -160,11 +184,12 @@ export const OverviewUsage = () => {
       <ScaffoldSectionContent className="gap-4">
         <div className="grid grid-cols-1 lg:grid-cols-2 gap-4">
           <StatCard
-            title="Active users"
+            title="Auth Activity" // https://supabase.slack.com/archives/C08N7894QTG/p1761210058358439?thread_ts=1761147906.491599&cid=C08N7894QTG
             current={metrics.current.activeUsers}
             previous={activeUsersChange}
             loading={isLoading}
             href={`/project/${ref}/reports/auth?its=${startDate}&ite=${endDate}#usage`}
+            tooltip="Users who generated any Auth event in this period. This metric tracks authentication activity, not total product usage. Some active users won't appear here if their session stayed valid."
           />
           <StatCard
             title="Sign ups"
diff --git a/apps/studio/data/reports/v2/auth-report.test.tsx b/apps/studio/data/reports/v2/auth-report.test.tsx
index 198b1ce902a..3a80edf7583 100644
--- a/apps/studio/data/reports/v2/auth-report.test.tsx
+++ b/apps/studio/data/reports/v2/auth-report.test.tsx
@@ -8,7 +8,7 @@ describe('defaultAuthReportFormatter', () => {
     const data = { result: [{ timestamp: String(timestamp), count: 1 }] }
 
     const attributes = [
-      { attribute: 'ActiveUsers', provider: 'logs', label: 'Active Users', enabled: true },
+      { attribute: 'ActiveUsers', provider: 'logs', label: 'Auth Activity', enabled: true },
     ]
 
     const result = defaultAuthReportFormatter(data, attributes)
@@ -28,7 +28,7 @@ describe('defaultAuthReportFormatter', () => {
     }
 
     const attributes = [
-      { attribute: 'active_users', label: 'Active Users' },
+      { attribute: 'active_users', label: 'Auth Activity' },
       { attribute: 'sign_in_attempts', label: 'Sign In Attempts' },
     ]
 
@@ -47,7 +47,7 @@ describe('defaultAuthReportFormatter', () => {
     const data = { result: [] }
 
     const attributes = [
-      { attribute: 'ActiveUsers', provider: 'logs', label: 'Active Users', enabled: true },
+      { attribute: 'ActiveUsers', provider: 'logs', label: 'Auth Activity', enabled: true },
     ]
 
     const result = defaultAuthReportFormatter(data, attributes)
diff --git a/apps/studio/data/reports/v2/auth.config.ts b/apps/studio/data/reports/v2/auth.config.ts
index 0c5b3b9b047..69e9ab74777 100644
--- a/apps/studio/data/reports/v2/auth.config.ts
+++ b/apps/studio/data/reports/v2/auth.config.ts
@@ -513,7 +513,7 @@ export const createUsageReportConfig = ({
   return [
     {
       id: 'active-user',
-      label: 'Active Users',
+      label: 'Auth Activity', // https://supabase.slack.com/archives/C08N7894QTG/p1761210058358439?thread_ts=1761147906.491599&cid=C08N7894QTG
       valuePrecision: 0,
       hide: false,
       showTooltip: true,
@@ -521,11 +521,12 @@ export const createUsageReportConfig = ({
       showMaxValue: false,
       hideChartType: false,
       defaultChartStyle: 'line',
-      titleTooltip: 'The total number of active users over time.',
+      titleTooltip:
+        "Users who generated any Auth event in this period. This metric tracks authentication activity, not total product usage. Some active users won't appear here if their session stayed valid.",
       availableIn: ['free', 'pro', 'team', 'enterprise'],
       dataProvider: async () => {
         const attributes = [
-          { attribute: 'ActiveUsers', provider: 'logs', label: 'Active Users', enabled: true },
+          { attribute: 'ActiveUsers', provider: 'logs', label: 'Auth Activity', enabled: true },
         ]
 
         const sql = AUTH_REPORT_SQL.ActiveUsers(interval, filters)