diff --git a/AGENTS.md b/AGENTS.md index c20580e9..ee4549c6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -49,6 +49,7 @@ DO NOT EVER DEPLOY WITHOUT CHECKING WITH THE USER - Navigation structure defined by `meta.json` files in content directories - Pages auto-generated based on file structure in `/content/docs/` - Custom components in `src/components/` for enhanced UI +- `/docs/sdk/*` wildcard path renders the SDK selector page before redirecting to the chosen platform (e.g. `/docs/sdk/quickstart/tracking-subscription-state` → `/docs/ios/quickstart/tracking-subscription-state`). ### Content Processing Plugins - `remark-tabs-syntax` - Processes tab syntax diff --git a/content/docs/dashboard/meta.json b/content/docs/dashboard/meta.json index 3f3154ac..22d63fc9 100644 --- a/content/docs/dashboard/meta.json +++ b/content/docs/dashboard/meta.json @@ -16,6 +16,7 @@ "products", "surveys", "overview-users", + "subscription-management", "dashboard-integrations", "overview-localization", "dashboard-settings", diff --git a/content/docs/dashboard/overview-users.mdx b/content/docs/dashboard/overview-users.mdx index 7431f7ba..841a869c 100644 --- a/content/docs/dashboard/overview-users.mdx +++ b/content/docs/dashboard/overview-users.mdx @@ -3,7 +3,7 @@ title: "Users" description: "Get a snapshot view of users who recently triggered a placement in your app, see their user journey, revenue events and more." --- -To view information about users who've recently triggered a placement in your app, **click** on the **Users** button in the sidebar: +To view information about users who've recently triggered a placement in your app, **click** on the **Users** button in the sidebar. Looking for a summary of how Superwall keeps subscription states in sync and where this data surfaces? See [Subscription Management](/dashboard/subscription-management). ![](/images/overview-users-sidebar.jpeg) diff --git a/content/docs/dashboard/subscription-management.mdx b/content/docs/dashboard/subscription-management.mdx new file mode 100644 index 00000000..c2a7c280 --- /dev/null +++ b/content/docs/dashboard/subscription-management.mdx @@ -0,0 +1,46 @@ +--- +title: "Subscription Management" +description: "See how Superwall manages subscription states end-to-end, surface that data in the dashboard, and distribute updates across your stack." +--- + + +## Overview + +- **One source of truth:** Superwall ingests purchase lifecycle events from the App Store, Play Store, and Stripe-powered web checkout flows. The platform reconciles those events into user entitlements that power paywall targeting, analytics, and access gates. +- **Entitlements-first:** Products attach to entitlements that represent access tiers. Learn more about configuring them in [Adding Products → Entitlements](/dashboard/products#entitlements). +- **Real-time syncing:** When an event (purchase, renewal, cancellation, refund) lands, Superwall updates the user profile and campaign eligibility automatically. + +## Dashboard + +### Users Page + +The Users page gives you a per-customer timeline that includes subscription events, paywall impressions, and entitlement snapshots. See [Users](/dashboard/overview-users) for the full walkthrough. + +- Confirm active entitlements and their expiration. +- Review recent renewals, cancellations, and billing issues. +- See paywall views, SDK events, and other analytics-style activity for that user. + +### Audience Filters & Campaign Targeting + +Campaigns can check entitlements directly, letting you show different paywalls or post-purchase experiences to subscribers vs. trials. See [Campaign Audience Filters](/dashboard/dashboard-campaigns/campaigns-audience) for details on the filter capabilities. + +## Web checkout + +Web checkout purchases follow the same entitlement pipeline as native stores and surface throughout the dashboard: + +- **Checkout and campaigns** – Configure Stripe credentials and connect campaigns that present web paywalls with [Configuring Stripe Keys and Settings](/dashboard/web-checkout/web-checkout-configuring-stripe-keys-and-settings) and [Creating Campaigns to Show Paywalls](/dashboard/web-checkout/web-checkout-creating-campaigns-to-show-paywalls). +- **Redemption** – After purchase, users receive a redemption email. Validate the flow using [Testing Purchases](/dashboard/web-checkout/web-checkout-testing-purchases) and share the manage URL pattern (`https://{your-domain}.superwall.app/manage`) for manual redemption. +- **Manage page** – Customers update billing, cancel, or request new redemption links from the manage portal documented in [Managing Memberships](/dashboard/web-checkout/web-checkout-managing-memberships). +- **Settings** – Brand the manage page and configure support contact info in **Settings → General → For Stripe apps**. See [General Settings](/dashboard/dashboard-settings/overview-settings) for field descriptions. + +## Integrations + +Superwall emits webhook events for every subscription lifecycle change. Connect these via the Integrations page to power downstream systems: + +- **Webhooks** – Review payloads and event types in [Integrations](/dashboard/integrations). Common uses include syncing CRM subscription status, triggering feature flags, or updating internal billing systems. +- **Slack** – Route high-value events into a revenue channel by enabling the [Slack integration](/dashboard/dashboard-integrations/inegrations-slack). +- **Analytics tools** – Send proceeds and lifecycle events into [Mixpanel](/dashboard/dashboard-integrations/inegrations-mixpanel) or other analytics tooling to correlate subscription momentum with product usage. + +## SDK + +Superwall's SDK tracks subscription status automatically based on your dashboard setup, so adding new products or entitlements does not require code changes. For platform-specific details, start with [Tracking Subscription State](/docs/sdk/quickstart/tracking-subscription-state).