From a37e434aa49dce9fdc65cf5064f63af841dbc3b5 Mon Sep 17 00:00:00 2001
From: Lukas Bernert <lukas@bernert.at>
Date: Fri, 16 Oct 2026 14:03:36 +0100
Subject: [PATCH] chore(studio): track docs link clicks in the region selector
 footer (#51841)

Adds `free_tier_general_region_docs_link_clicked` event, fired when the
regions docs link in the selector footer is clicked
---
 .../interfaces/ProjectCreation/RegionSelector.tsx   |  5 ++++-
 packages/common/telemetry-constants.ts              | 13 +++++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/apps/studio/components/interfaces/ProjectCreation/RegionSelector.tsx b/apps/studio/components/interfaces/ProjectCreation/RegionSelector.tsx
index ad5e46314c2..70cb905dc33 100644
--- a/apps/studio/components/interfaces/ProjectCreation/RegionSelector.tsx
+++ b/apps/studio/components/interfaces/ProjectCreation/RegionSelector.tsx
@@ -403,7 +403,10 @@ export const RegionSelector = ({
                               Upgrade to Pro
                             </InlineLink>{' '}
                             to choose a{' '}
-                            <InlineLink href={`${DOCS_URL}/guides/platform/regions`}>
+                            <InlineLink
+                              href={`${DOCS_URL}/guides/platform/regions`}
+                              onClick={() => track('free_tier_general_region_docs_link_clicked')}
+                            >
                               specific region
                             </InlineLink>
                             .
diff --git a/packages/common/telemetry-constants.ts b/packages/common/telemetry-constants.ts
index 09e97e22bae..f8a06c56ed0 100644
--- a/packages/common/telemetry-constants.ts
+++ b/packages/common/telemetry-constants.ts
@@ -555,6 +555,18 @@ export interface FreeTierGeneralRegionUpgradeClickedEvent {
   groups: Omit<TelemetryGroups, 'project'>
 }
 
+/**
+ * User clicked the "specific region" docs link in the region selector's footer.
+ *
+ * @group Events
+ * @source studio
+ * @page new/{slug} and /integrations/vercel/{slug}/deploy-button/new-project
+ */
+export interface FreeTierGeneralRegionDocsLinkClickedEvent {
+  action: 'free_tier_general_region_docs_link_clicked'
+  groups: Omit<TelemetryGroups, 'project'>
+}
+
 /**
  * User clicked the "Need a specific region?" link to reveal the specific regions
  * list in the project creation region selector.
@@ -4189,6 +4201,7 @@ export type TelemetryEvent =
   | ProjectCreationFormExposedEvent
   | FreeTierGeneralRegionExperimentExposedEvent
   | FreeTierGeneralRegionUpgradeClickedEvent
+  | FreeTierGeneralRegionDocsLinkClickedEvent
   | ProjectCreationSpecificRegionLinkClickedEvent
   | OrganizationCreationFormExposedEvent
   | OrganizationCreationCompletedEvent