From d5f5b4091c5496396495cddf08bf05a7c4946a57 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 25 May 2026 19:13:17 +0000
Subject: [PATCH] docs: improve SEO descriptions across docs pages

---
 account/billing.mdx                             | 2 +-
 account/branding.mdx                            | 2 +-
 account/members.mdx                             | 2 +-
 account/overview.mdx                            | 2 +-
 admin-api/authentication.mdx                    | 3 +--
 admin-api/client-libraries.mdx                  | 2 +-
 admin-api/introduction.mdx                      | 3 +--
 admin-api/rate-limiting.mdx                     | 2 +-
 api-reference/authentication.mdx                | 3 +--
 api-reference/client-libraries.mdx              | 2 +-
 api-reference/idempotency.mdx                   | 3 +--
 api-reference/introduction.mdx                  | 2 +-
 api-reference/rate-limiting.mdx                 | 2 +-
 features/achievements.mdx                       | 2 +-
 features/emails.mdx                             | 2 +-
 features/events.mdx                             | 3 +--
 features/leaderboards.mdx                       | 2 +-
 features/metrics.mdx                            | 4 +---
 features/overview.mdx                           | 2 +-
 features/points.mdx                             | 2 +-
 features/push-notifications.mdx                 | 3 +--
 features/streaks.mdx                            | 2 +-
 features/users.mdx                              | 2 +-
 getting-started/introduction.mdx                | 2 +-
 getting-started/quickstart.mdx                  | 2 +-
 guides/gamified-fitness-platform.mdx            | 4 +---
 guides/gamified-study-platform.mdx              | 3 +--
 guides/how-to-build-a-leaderboards-feature.mdx  | 3 +--
 guides/how-to-build-a-streaks-feature.mdx       | 2 +-
 guides/how-to-build-an-achievements-feature.mdx | 3 +--
 guides/how-to-build-an-energy-feature.mdx       | 2 +-
 guides/how-to-build-an-xp-feature.mdx           | 2 +-
 platform/environments.mdx                       | 2 +-
 platform/experimentation.mdx                    | 3 +--
 platform/multi-tenancy.mdx                      | 2 +-
 platform/overview.mdx                           | 2 +-
 uikit/overview.mdx                              | 1 +
 webhooks/idempotency.mdx                        | 3 +--
 webhooks/introduction.mdx                       | 3 +--
 webhooks/observability.mdx                      | 2 +-
 webhooks/quickstart.mdx                         | 2 +-
 webhooks/retries.mdx                            | 2 +-
 webhooks/security.mdx                           | 2 +-
 43 files changed, 43 insertions(+), 58 deletions(-)

diff --git a/account/billing.mdx b/account/billing.mdx
index 81f6402..9e5e0f8 100644
--- a/account/billing.mdx
+++ b/account/billing.mdx
@@ -1,6 +1,6 @@
 ---
 title: Billing
-description: Learn how Trophy controls costs by charging based on monthly active users.
+description: Understand Trophy's usage-based pricing model based on monthly active users, plan tiers, free quotas, and how to manage your subscription.
 og:description: Learn how Trophy controls costs by charging based on monthly active users.
 icon: gauge
 ---
diff --git a/account/branding.mdx b/account/branding.mdx
index c84a812..4e31a37 100644
--- a/account/branding.mdx
+++ b/account/branding.mdx
@@ -1,6 +1,6 @@
 ---
 title: Branding
-description: Configure your logo and brand colors used across features built with Trophy.
+description: Configure your organization's logo, brand colors, and visual identity used across Trophy emails, push notifications, and gamified experiences.
 og:description: Learn how Trophy tracks usage according to the number of users
   that use your product.
 icon: palette
diff --git a/account/members.mdx b/account/members.mdx
index 37fb02e..bbbd46b 100644
--- a/account/members.mdx
+++ b/account/members.mdx
@@ -1,6 +1,6 @@
 ---
 title: Members
-description: Give team members access to Trophy and manage your account settings.
+description: Invite teammates to your Trophy organization, manage member roles and permissions, and control access to your gamification dashboard.
 og:description: Give team members access to Trophy and manage your account settings.
 icon: user-plus
 ---
diff --git a/account/overview.mdx b/account/overview.mdx
index ad24a00..6bea64c 100644
--- a/account/overview.mdx
+++ b/account/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: Overview
-description: Learn how to manage your Trophy account.
+description: Manage your Trophy organization including team members, billing details, branding, and other account-level settings from the Trophy dashboard.
 ---
 
 From inviting team members to understanding billing, this section of the documentation is dedicated to managing your Trophy account.
diff --git a/admin-api/authentication.mdx b/admin-api/authentication.mdx
index 9fc846d..a4d58bc 100644
--- a/admin-api/authentication.mdx
+++ b/admin-api/authentication.mdx
@@ -1,7 +1,6 @@
 ---
 title: Authentication
-description: Integrate securely with the API using account-level API keys
-  transmitted in the `X-API-KEY` header.
+description: Authenticate Trophy Admin API requests securely using account-level API keys transmitted in the X-API-KEY header from your server.
 og:description: Integrate securely with the Trophy API using account-level API
   keys transmitted in the `X-API-KEY` header.
 icon: key
diff --git a/admin-api/client-libraries.mdx b/admin-api/client-libraries.mdx
index e038f08..401b203 100644
--- a/admin-api/client-libraries.mdx
+++ b/admin-api/client-libraries.mdx
@@ -1,6 +1,6 @@
 ---
 title: Client Libraries
-description: Use Trophy's type-safe SDKs to integrate with the API.
+description: Use Trophy's type-safe SDKs in Node.js, Python, Go, Ruby, and more to call Admin API endpoints through the trophy.admin client namespace.
 og:description: Use Trophy's type-safe SDKs to integrate with the API and start
   building gamified product experiences.
 icon: code-xml
diff --git a/admin-api/introduction.mdx b/admin-api/introduction.mdx
index d581555..9017a73 100644
--- a/admin-api/introduction.mdx
+++ b/admin-api/introduction.mdx
@@ -1,7 +1,6 @@
 ---
 title: Introduction
-description: Learn about the Trophy Admin API and how to use it to drive custom
-  workflows using Trophy data.
+description: Drive custom gamification workflows using the Trophy Admin API to manage metrics, achievements, leaderboards, and points programmatically.
 subtitle: Learn about the Trophy Admin API and how to use it to drive custom
   workflows using Trophy data.
 ---
diff --git a/admin-api/rate-limiting.mdx b/admin-api/rate-limiting.mdx
index 7c800f6..fa9cf4e 100644
--- a/admin-api/rate-limiting.mdx
+++ b/admin-api/rate-limiting.mdx
@@ -1,6 +1,6 @@
 ---
 title: Rate Limiting
-description: Learn about the Trophy API and request rate limiting.
+description: Learn the Trophy Admin API rate limits, tiered request quotas, and how to handle 429 responses when integrating administrative workflows.
 og:description: Learn about the Trophy API and request rate limiting.
 icon: circle-gauge
 ---
diff --git a/api-reference/authentication.mdx b/api-reference/authentication.mdx
index 0c3cca9..4170700 100644
--- a/api-reference/authentication.mdx
+++ b/api-reference/authentication.mdx
@@ -1,7 +1,6 @@
 ---
 title: Authentication
-description: Integrate securely with the API using account-level API keys
-  transmitted in the `X-API-KEY` header.
+description: Authenticate Trophy Application API requests securely from your backend using account-level API keys sent in the X-API-KEY header.
 og:description: Integrate securely with the Trophy API using account-level API
   keys transmitted in the `X-API-KEY` header.
 icon: key
diff --git a/api-reference/client-libraries.mdx b/api-reference/client-libraries.mdx
index 3cc65d8..0ba1de3 100644
--- a/api-reference/client-libraries.mdx
+++ b/api-reference/client-libraries.mdx
@@ -1,6 +1,6 @@
 ---
 title: Client Libraries
-description: Use Trophy's type-safe SDKs to integrate with the API.
+description: Integrate the Trophy Application API using official SDKs available in Node.js, Python, Go, Ruby, Java, and PHP for type-safe gamification.
 og:description: Use Trophy's type-safe SDKs to integrate with the API and start
   building gamified product experiences.
 icon: code-xml
diff --git a/api-reference/idempotency.mdx b/api-reference/idempotency.mdx
index c2b1807..6017600 100644
--- a/api-reference/idempotency.mdx
+++ b/api-reference/idempotency.mdx
@@ -1,7 +1,6 @@
 ---
 title: Idempotency
-description: Prevent unintended side effects when retrying requests with
-  idempotency controls built into the Trophy API and SDKs.
+description: Use the Idempotency-Key header and built-in SDK controls to safely retry Trophy API requests without double-counting events or awards.
 og:description: Prevent unintended side effects when retrying requests with
   idempotency built into the Trophy API and SDKs using the
   `Idempotency-Key` request header.
diff --git a/api-reference/introduction.mdx b/api-reference/introduction.mdx
index fcc73f0..eae4079 100644
--- a/api-reference/introduction.mdx
+++ b/api-reference/introduction.mdx
@@ -1,6 +1,6 @@
 ---
 title: Introduction
-description: Learn about the Trophy API and get started building your integration.
+description: Get started with the Trophy Application API to build achievements, streaks, points, and leaderboards into your web or mobile application.
 subtitle: Learn about the Trophy API and get started building your integration.
 ---
 
diff --git a/api-reference/rate-limiting.mdx b/api-reference/rate-limiting.mdx
index 68f3365..18b710b 100644
--- a/api-reference/rate-limiting.mdx
+++ b/api-reference/rate-limiting.mdx
@@ -1,6 +1,6 @@
 ---
 title: Rate Limiting
-description: Learn about the Trophy API and request rate limiting.
+description: Learn the Trophy Application API rate limit tiers, per-endpoint quotas, and how to handle 429 responses gracefully in your integration.
 og:description: Learn about the Trophy API and request rate limiting.
 icon: circle-gauge
 ---
diff --git a/features/achievements.mdx b/features/achievements.mdx
index 777fba8..a6528c6 100644
--- a/features/achievements.mdx
+++ b/features/achievements.mdx
@@ -1,6 +1,6 @@
 ---
 title: Achievements
-description: Learn how to use Achievements in a gamified product experience with Trophy.
+description: Reward users with metric, API, streak, and composite achievements to encourage progress and drive discovery across your product experience.
 og:description: Use metric, API, streak and composite achievements to reward
   users for continued progress and to encourage them to discover new parts of
   your app.
diff --git a/features/emails.mdx b/features/emails.mdx
index e1b06e0..4b9034f 100644
--- a/features/emails.mdx
+++ b/features/emails.mdx
@@ -1,6 +1,6 @@
 ---
 title: Emails
-description: Learn how to use emails in a gamified product experience with Trophy.
+description: Send automated, branded gamification emails like progress updates and reactivation messages to keep users engaged outside your app.
 og:description: Use automated email flows to extend your gamification experience
   outside your app and remind users to keep coming back.
 icon: mail
diff --git a/features/events.mdx b/features/events.mdx
index ad545aa..59d72ae 100644
--- a/features/events.mdx
+++ b/features/events.mdx
@@ -1,7 +1,6 @@
 ---
 title: Events
-description: Events are data objects that represent individual user interactions
-  against metrics in Trophy.
+description: Send events to Trophy to represent user interactions against metrics and trigger achievements, streaks, points, and leaderboard updates.
 og:description: Events are data objects that represent individual user
   interactions against metrics in Trophy.
 icon: radio
diff --git a/features/leaderboards.mdx b/features/leaderboards.mdx
index ebf05e2..6d9234f 100644
--- a/features/leaderboards.mdx
+++ b/features/leaderboards.mdx
@@ -1,6 +1,6 @@
 ---
 title: Leaderboards
-description: Learn how to use Leaderboards in a gamified product experience with Trophy.
+description: Create daily, weekly, or monthly recurring leaderboards that rank users by metrics, points, or streaks to drive competition and engagement.
 og:description: Create daily, weekly or monthly competitions that rank users
   based on metrics, points or streaks and increase user engagement.
 icon: /icons/leaderboard.svg
diff --git a/features/metrics.mdx b/features/metrics.mdx
index 1173994..820a13d 100644
--- a/features/metrics.mdx
+++ b/features/metrics.mdx
@@ -1,8 +1,6 @@
 ---
 title: Metrics
-description: Learn how to model user interactions using Trophy Metrics. Model
-  any user interaction and trigger automated gamification flows with just a few
-  lines of code.
+description: Model any user interaction with Trophy metrics to power achievements, streaks, points, and leaderboards from a single source of truth.
 og:description: Metrics are flexible data primitives that can be used to model
   any user interaction and drive a wide range of gamified features.
 icon: box
diff --git a/features/overview.mdx b/features/overview.mdx
index d6705c7..10e859f 100644
--- a/features/overview.mdx
+++ b/features/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: Overview
-description: Learn the key concepts behind Trophy's gamification system.
+description: Understand the core Trophy concepts including metrics, events, users, achievements, streaks, points, and leaderboards that power gamification.
 og:description: Learn the key concepts behind Trophy's gamification system
   including Metrics, Events, Achievements and Streaks.
 ---
diff --git a/features/points.mdx b/features/points.mdx
index d6c92cc..1520b3a 100644
--- a/features/points.mdx
+++ b/features/points.mdx
@@ -1,6 +1,6 @@
 ---
 title: Points
-description: Learn how to build points-based systems using Trophy
+description: Build XP and points systems with triggers, levels, and boosts to reward users for in-app actions and create long-term progression loops.
 og:description: Use points systems to reward users for in-app actions.
 icon: sparkle
 ---
diff --git a/features/push-notifications.mdx b/features/push-notifications.mdx
index 225a60f..40b1b0a 100644
--- a/features/push-notifications.mdx
+++ b/features/push-notifications.mdx
@@ -1,7 +1,6 @@
 ---
 title: Push Notifications
-description: Learn how to use push notifications in a gamified product
-  experience with Trophy.
+description: Send automated, branded push notifications for achievements, streaks, and progress updates to bring users back into your mobile app.
 og:description: Use automated push notification flows to extend your
   gamification experience outside your app and remind users to keep coming back.
 icon: bell
diff --git a/features/streaks.mdx b/features/streaks.mdx
index 697cdc8..babf60d 100644
--- a/features/streaks.mdx
+++ b/features/streaks.mdx
@@ -1,6 +1,6 @@
 ---
 title: Streaks
-description: Learn how to use streaks in a gamified product experience with Trophy.
+description: Build daily, weekly, or monthly streaks with streak freezes and rankings to create habits and keep users returning to your app daily.
 og:description: Use daily, weekly or monthly streaks to create habitual usage
   patterns and keep users coming back to your app.
 icon: flame
diff --git a/features/users.mdx b/features/users.mdx
index 860cdcb..5fa3a12 100644
--- a/features/users.mdx
+++ b/features/users.mdx
@@ -1,6 +1,6 @@
 ---
 title: Users
-description: Learn how to track interactions across your userbase using Trophy.
+description: Identify and track users in Trophy to attribute events, achievements, streaks, and points across your entire product userbase over time.
 og:description: Users are the people that use your platform. Learn how to tell
   Trophy about them.
 icon: users
diff --git a/getting-started/introduction.mdx b/getting-started/introduction.mdx
index ab57bc7..f0d3793 100644
--- a/getting-started/introduction.mdx
+++ b/getting-started/introduction.mdx
@@ -1,6 +1,6 @@
 ---
 title: Welcome to Trophy
-description: Trophy documentation for gamification APIs, quickstart guides and tutorials.
+description: Trophy is a developer toolkit for adding achievements, streaks, points, leaderboards, and gamified emails to any web or mobile app.
 ---
 
 Trophy is a developer-friendly toolkit for building gamified product experiences in any mobile or web app.
diff --git a/getting-started/quickstart.mdx b/getting-started/quickstart.mdx
index 46d24e8..6b8454a 100644
--- a/getting-started/quickstart.mdx
+++ b/getting-started/quickstart.mdx
@@ -1,6 +1,6 @@
 ---
 title: Quick Start
-description: Get up and running with Trophy in under 10 minutes
+description: Integrate Trophy into your backend in under 10 minutes to start tracking events, awarding achievements, and powering gamified user experiences.
 og:description: Follow this quick start guide to integrate Trophy into your
   backend and add gamified features like achievements and streaks into your app.
 ---
diff --git a/guides/gamified-fitness-platform.mdx b/guides/gamified-fitness-platform.mdx
index 0635772..4e80b69 100644
--- a/guides/gamified-fitness-platform.mdx
+++ b/guides/gamified-fitness-platform.mdx
@@ -1,8 +1,6 @@
 ---
 title: How to Build a Gamified Fitness Tracker
-description: Learn how to build a Strava-like fitness app with Next.js,
-  featuring multi-sport tracking, city-based leaderboards, and normalized XP
-  progression.
+description: Build a Strava-style fitness app with Next.js and Trophy, featuring multi-sport tracking, city leaderboards, streaks, and XP progression.
 subtitle: Build a high-retention fitness app with streaks and leaderboards.
 ---
 
diff --git a/guides/gamified-study-platform.mdx b/guides/gamified-study-platform.mdx
index 88728f8..4f1900e 100644
--- a/guides/gamified-study-platform.mdx
+++ b/guides/gamified-study-platform.mdx
@@ -1,7 +1,6 @@
 ---
 title: How to Build a Gamified Study Platform
-description: Follow along as we build out a gamified study platform using Trophy
-  with achievements, a daily streak, XP and leaderboards.
+description: Build a gamified study platform with Trophy using achievements, daily streaks, XP, levels, and leaderboards to drive learner engagement.
 subtitle: Follow along as we build out a gamified study platform using Trophy.
 noindex: true
 ---
diff --git a/guides/how-to-build-a-leaderboards-feature.mdx b/guides/how-to-build-a-leaderboards-feature.mdx
index c20f6bb..f2e7c34 100644
--- a/guides/how-to-build-a-leaderboards-feature.mdx
+++ b/guides/how-to-build-a-leaderboards-feature.mdx
@@ -1,7 +1,6 @@
 ---
 title: How To Build A Leaderboards Feature
-description: Learn how to use Trophy to add a leaderboards feature to your web
-  or mobile app.
+description: Add ranked leaderboards to your web or mobile app with Trophy, including setup, recurring runs, tie-breakers, and displaying user rankings.
 subtitle: Learn how to use Trophy to add a leaderboards feature to your web or
   mobile app.
 noindex: true
diff --git a/guides/how-to-build-a-streaks-feature.mdx b/guides/how-to-build-a-streaks-feature.mdx
index 3cd7d46..74e724f 100644
--- a/guides/how-to-build-a-streaks-feature.mdx
+++ b/guides/how-to-build-a-streaks-feature.mdx
@@ -1,6 +1,6 @@
 ---
 title: How To Build A Streaks Feature
-description: Learn how to use Trophy to add a streaks feature to your web or mobile app.
+description: Add a daily, weekly, or monthly streak feature to your web or mobile app using Trophy with streak freezes and progress UI components.
 subtitle: Learn how to use Trophy to add a streaks feature to your web or mobile app.
 noindex: true
 ---
diff --git a/guides/how-to-build-an-achievements-feature.mdx b/guides/how-to-build-an-achievements-feature.mdx
index d29ef3f..2695988 100644
--- a/guides/how-to-build-an-achievements-feature.mdx
+++ b/guides/how-to-build-an-achievements-feature.mdx
@@ -1,7 +1,6 @@
 ---
 title: How To Build An Achievements Feature
-description: Learn how to use Trophy to add an achievements feature to your web
-  or mobile app.
+description: Add metric, API, and composite achievements to your web or mobile app using Trophy, including unlocking, displaying, and rewarding users.
 subtitle: Learn how to use Trophy to add an achievements feature to your web or
   mobile app.
 noindex: true
diff --git a/guides/how-to-build-an-energy-feature.mdx b/guides/how-to-build-an-energy-feature.mdx
index 48ed6f5..20d964f 100644
--- a/guides/how-to-build-an-energy-feature.mdx
+++ b/guides/how-to-build-an-energy-feature.mdx
@@ -1,6 +1,6 @@
 ---
 title: How To Build An Energy Feature
-description: Learn how to use Trophy to add an energy feature to your web or mobile app.
+description: Build an energy or stamina system in your web or mobile app using Trophy points to limit user actions and create rest-and-recover loops.
 subtitle: Learn how to use Trophy to add an energy feature to your web or mobile app.
 noindex: true
 ---
diff --git a/guides/how-to-build-an-xp-feature.mdx b/guides/how-to-build-an-xp-feature.mdx
index a15f61a..c0c809e 100644
--- a/guides/how-to-build-an-xp-feature.mdx
+++ b/guides/how-to-build-an-xp-feature.mdx
@@ -1,6 +1,6 @@
 ---
 title: How To Build An XP Feature
-description: Learn how to use Trophy to add an XP feature to your web or mobile app.
+description: Add an XP and levels system to your web or mobile app with Trophy points, level triggers, progress bars, and reward unlocks for users.
 subtitle: Learn how to use Trophy to add an XP feature to your web or mobile app.
 noindex: true
 ---
diff --git a/platform/environments.mdx b/platform/environments.mdx
index eb9ca73..2661286 100644
--- a/platform/environments.mdx
+++ b/platform/environments.mdx
@@ -1,6 +1,6 @@
 ---
 title: Environments
-description: Learn how to use environments to help you test and review changes before releasing to production.
+description: Isolate development, staging, and production data with Trophy environments and safely promote gamification changes before going live.
 og:description: Learn how to use environments to help you test and review changes before releasing to production.
 icon: layers
 ---
diff --git a/platform/experimentation.mdx b/platform/experimentation.mdx
index 7a0541e..fc2202b 100644
--- a/platform/experimentation.mdx
+++ b/platform/experimentation.mdx
@@ -1,7 +1,6 @@
 ---
 title: Experimentation
-description: Learn how to use Trophy to experiment with the gamification
-  experience and increase retention and user engagement.
+description: Run A/B tests on your Trophy gamification experience with control flags to measure retention and engagement lifts before rolling out.
 og:description: Learn how to use Trophy to experiment with the gamification
   experience and increase retention and user engagement.
 icon: flask-conical
diff --git a/platform/multi-tenancy.mdx b/platform/multi-tenancy.mdx
index cafceda..6b43d21 100644
--- a/platform/multi-tenancy.mdx
+++ b/platform/multi-tenancy.mdx
@@ -1,6 +1,6 @@
 ---
 title: Multi-Tenancy
-description: Learn how to use multi-tenancy to help you set up and customize gamification features for each of your customers.
+description: Use Trophy multi-tenancy to provision and customize separate gamification configurations for each of your B2B customers from one account.
 og:description: Learn how to use multi-tenancy to help you set up and customize gamification features for each of your customers.
 icon: building
 ---
diff --git a/platform/overview.mdx b/platform/overview.mdx
index d03fe24..7524951 100644
--- a/platform/overview.mdx
+++ b/platform/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: Overview
-description: Learn how to configure and operate the Trophy platform.
+description: Configure and operate the Trophy platform using environments, multi-tenancy, and experimentation to manage gamification across customers at scale.
 ---
 
 From isolating data across environments to powering multi-tenant gamification and running experiments on your gamification experience, this section of the documentation covers how to configure and operate the Trophy platform.
diff --git a/uikit/overview.mdx b/uikit/overview.mdx
index 66b71d7..e88e8e2 100644
--- a/uikit/overview.mdx
+++ b/uikit/overview.mdx
@@ -1,5 +1,6 @@
 ---
 title: Gamification UI Kit
+description: Trophy's Gamification UI Kit is a React component library built on shadcn/ui for streaks, achievements, leaderboards, points, and levels.
 ---
 
 <Frame>
diff --git a/webhooks/idempotency.mdx b/webhooks/idempotency.mdx
index 084c019..6a51a5b 100644
--- a/webhooks/idempotency.mdx
+++ b/webhooks/idempotency.mdx
@@ -1,7 +1,6 @@
 ---
 title: Idempotency
-description: Learn how to ensure your webhook endpoints only process events once
-  to prevent unintended side effects.
+description: Make your Trophy webhook handlers idempotent using event IDs so you safely process each event exactly once even when retries occur.
 subtitle: Learn how to ensure your webhook endpoints only process events once to
   prevent unintended side effects.
 icon: repeat
diff --git a/webhooks/introduction.mdx b/webhooks/introduction.mdx
index 4072384..d1025fd 100644
--- a/webhooks/introduction.mdx
+++ b/webhooks/introduction.mdx
@@ -1,7 +1,6 @@
 ---
 title: Introduction
-description: Learn about webhooks in Trophy and how to use them to power custom
-  gamification integrations.
+description: Receive Trophy webhook events for achievements, streaks, points, and leaderboards to power custom integrations and real-time workflows.
 subtitle: Learn about webhooks in Trophy and how to use them to power custom
   gamification integrations.
 ---
diff --git a/webhooks/observability.mdx b/webhooks/observability.mdx
index e198c72..bc14740 100644
--- a/webhooks/observability.mdx
+++ b/webhooks/observability.mdx
@@ -1,6 +1,6 @@
 ---
 title: Observability
-description: Learn how to monitor and diagnose issues with webhook delivery.
+description: Monitor and diagnose Trophy webhook delivery using built-in dashboard analytics, status tracking, payload inspection, and delivery logs.
 subtitle: Learn how to monitor and diagnose issues with webhook delivery.
 icon: activity
 ---
diff --git a/webhooks/quickstart.mdx b/webhooks/quickstart.mdx
index c881d6b..a7f1df6 100644
--- a/webhooks/quickstart.mdx
+++ b/webhooks/quickstart.mdx
@@ -1,6 +1,6 @@
 ---
 title: Quick Start
-description: Start receiving webhook events from Trophy in under 10 minutes.
+description: Configure a Trophy webhook endpoint in under 10 minutes and start receiving real-time gamification events directly in your backend service.
 subtitle: Start receiving webhook events from Trophy in under 10 minutes.
 icon: circle-play
 ---
diff --git a/webhooks/retries.mdx b/webhooks/retries.mdx
index cb36008..7026b51 100644
--- a/webhooks/retries.mdx
+++ b/webhooks/retries.mdx
@@ -1,6 +1,6 @@
 ---
 title: Retries
-description: Learn how Trophy handles webhook retries with configured endpoints.
+description: Understand how Trophy retries failed webhook deliveries after timeouts or non-2xx responses, with backoff schedules and dead-letter handling.
 subtitle: Learn how Trophy handles webhook retries with configured endpoints.
 icon: rotate-ccw
 ---
diff --git a/webhooks/security.mdx b/webhooks/security.mdx
index e899fe6..4a8e3a1 100644
--- a/webhooks/security.mdx
+++ b/webhooks/security.mdx
@@ -1,6 +1,6 @@
 ---
 title: Security
-description: Build secure webhook endpoints using webhook signature verification.
+description: Secure your Trophy webhook endpoints by verifying signed payloads with HMAC signatures to ensure events come from Trophy and not attackers.
 subtitle: Build secure webhook endpoints using webhook signature verification.
 icon: shield-check
 ---