From 9c9477c1cf7c0e52d2a6b15748e9b4af5df3a9eb Mon Sep 17 00:00:00 2001
From: Ben Senescu <44480372+bensenescu@users.noreply.github.com>
Date: Fri, 22 May 2026 21:47:28 -0400
Subject: [PATCH] Clarify keyword metric tooltips (#216)

---
 src/client/features/domain/components/DomainKeywordsTable.tsx | 2 +-
 .../features/keywords/page/KeywordResearchDesktopTable.tsx    | 4 ++--
 src/client/features/saved-keywords/SavedKeywordsTable.tsx     | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/client/features/domain/components/DomainKeywordsTable.tsx b/src/client/features/domain/components/DomainKeywordsTable.tsx
index c0aab87..81b1342 100644
--- a/src/client/features/domain/components/DomainKeywordsTable.tsx
+++ b/src/client/features/domain/components/DomainKeywordsTable.tsx
@@ -128,7 +128,7 @@ function DomainKeywordsTableComponent({
         header: () => (
           <SortableHeader
             label="Score"
-            helpText="Keyword difficulty score."
+            helpText="Organic ranking difficulty (0-100): higher means harder to reach Google's top 10."
             isActive={sortMode === "score"}
             order={currentSortOrder}
             onClick={() => onSortClick("score")}
diff --git a/src/client/features/keywords/page/KeywordResearchDesktopTable.tsx b/src/client/features/keywords/page/KeywordResearchDesktopTable.tsx
index 0bdfc79..6b2839e 100644
--- a/src/client/features/keywords/page/KeywordResearchDesktopTable.tsx
+++ b/src/client/features/keywords/page/KeywordResearchDesktopTable.tsx
@@ -127,7 +127,7 @@ export function KeywordResearchDesktopTable({
         header: () => (
           <SortHeader
             label="Comp."
-            helpText="Advertiser competition."
+            helpText="Paid-search competition from Google Ads (0-1): higher means more advertisers bidding."
             field="competition"
             current={sortField}
             dir={sortDir}
@@ -149,7 +149,7 @@ export function KeywordResearchDesktopTable({
         header: () => (
           <SortHeader
             label="Score"
-            helpText="Keyword difficulty score."
+            helpText="Organic ranking difficulty (0-100): higher means harder to reach Google's top 10."
             field="keywordDifficulty"
             current={sortField}
             dir={sortDir}
diff --git a/src/client/features/saved-keywords/SavedKeywordsTable.tsx b/src/client/features/saved-keywords/SavedKeywordsTable.tsx
index 36df602..37da16a 100644
--- a/src/client/features/saved-keywords/SavedKeywordsTable.tsx
+++ b/src/client/features/saved-keywords/SavedKeywordsTable.tsx
@@ -72,7 +72,7 @@ export function SavedKeywordsTable({
           <SortableHeader
             column={column}
             label="Competition"
-            helpText="Advertiser competition."
+            helpText="Paid-search competition from Google Ads (0-1): higher means more advertisers bidding."
           />
         ),
         cell: ({ getValue }) => {
@@ -85,7 +85,7 @@ export function SavedKeywordsTable({
           <SortableHeader
             column={column}
             label="Difficulty"
-            helpText="Keyword difficulty score."
+            helpText="Organic ranking difficulty (0-100): higher means harder to reach Google's top 10."
           />
         ),
         cell: ({ getValue }) => <DifficultyBadge value={getValue()} />,