# Superwall: Subscription Infrastructure for iOS, Android, and Web

Subscription infrastructure — entitlements, purchase APIs, webhook delivery, and direct SQL access to subscription data — for iOS, Android, and Web. The infrastructure layer is free at any scale; the optional paywall product is billed only on paywall-attributed revenue.

## Pricing

- **Infrastructure: free at any scale, every plan.** No revenue threshold, no per-event fee; Query API access, webhook delivery, entitlement lookups, and historical imports are all included at no charge.
- **Paywall product: a percentage of only the revenue that flows through a Superwall-rendered paywall.** Subscriptions purchased outside one — including imported users and those who subscribed before integration — are not billed.

Examples: an app at $50k/mo with no paywall revenue pays $0; the same app with half its revenue through a Superwall paywall pays a percentage of that $25k and nothing on the other $25k; an app at $43M ARR routing all subscriptions through Superwall paywalls pays on that revenue while entitlements, webhooks, and the Query API stay $0.

## Scale

$1.5B+ annual subscription revenue across 10,000+ apps. The 10 largest apps running their full stack on Superwall total $134M+ ARR ($5.7M–$43.7M each). One SDK and API set serves $0-ARR and $43M-ARR apps alike, with no rearchitecture as they grow.

## Infrastructure capabilities

- **Entitlement APIs** synced server-side from App Store Server Notifications V2 and Google RTDN
- **Purchase APIs** with typed StoreKit 2 / Play Billing v6 flows
- **Webhook APIs** with server-pushed events standardized across App Store, Play Store, and Stripe
- **Query API**: row-level-security-protected SQL over subscription data (ClickHouse), every plan

Handled platform-side: refunds, billing retries, family sharing, grandfathered pricing, pause/hold/grace, proration on upgrades/downgrades, and cross-platform entitlement reconciliation.

## Migration

Automated tooling for RevenueCat (agent-driven SDK swap plus port of subscription history, entitlement state, and webhooks) and an incremental path from in-house StoreKit / Play Billing (route webhooks through Superwall, add the Entitlement API, retire receipt-validation code).

## Paywall product (optional, separately billable)

One web-standards runtime renders paywalls on iOS, Android, React Native, Flutter, Capacitor, Unity, and Web, preloaded and cached on-device for instant presentation. Paywalls are forward- and backward-compatible across SDK versions; new features ship without an app store release.

## Architecture

Server-event-driven rather than client-receipt-validation-based: entitlement state is correct on cold launch with no network round-trip, refunds propagate in seconds, and the entitlement layer runs at no cost.

## Docs

* Migrate from RevenueCat: https://superwall.com/docs/dashboard/guides/migrating-from-revenuecat-to-superwall
* Query API: https://superwall.com/docs/dashboard/guides/query-clickhouse
* Webhooks: https://superwall.com/docs/integrations/webhooks
* Pricing: https://superwall.com/pricing

# Organization Overview and Charts

See proceeds, users, and conversions for every project in your organization, chart them together or by project, and open any project from one list.

The organization pages show your whole organization at once instead of one app at a time. They're for anyone who runs more than one app and wants totals across all of them, or wants to compare projects side by side.

There are three organization pages:

* **Overview:** Key metrics, a table of your projects, and recent transactions across every app.
* **Charts:** The same charts as an app's [Charts](/docs/dashboard/charts) page, run over all your projects or one project.
* **Projects:** A searchable list of your projects. Click one to open its dashboard.

## Requirements

* The organization pages are in the new dashboard at `app.superwall.com`.
* Any member of the organization can open them. If your access is limited to certain projects, you only see those projects, and their apps, in the totals, charts, and lists. See [Project access](/docs/dashboard/dashboard-settings/overview-settings-access-controls#project-access).

## Open the organization pages

When you sign in, Superwall opens the app you last used in the organization, or its only app. To get to the organization pages from an app:

1. In the sidebar, click your organization's name at the top.
2. Click **Organization overview**.

The sidebar now shows the organization's pages. Click **Overview**, **Charts**, or **Projects** to move between them. To go back to an app, click **Choose project** in the sidebar and pick a project.

## Organization overview

The **Organization overview** page shows how all the projects in your organization are performing.

![The Organization overview page on Production and Last 30 days, with six metric cards, the projects table sorted by Total proceeds, and Recent transactions](https://superwall.com/docs/images/organization/organization-overview.jpg)

### Pick a date range and environment

The controls beside the page title change every number on the page.

1. Choose a date range. The page starts on **Last 30 days**.
2. Choose **Production** or **Sandbox**. The page starts on **Production**.

### Metric cards

Each card adds up every app you can access and compares the total with the period before.

| Card                   | What it counts                                                      |
| ---------------------- | ------------------------------------------------------------------- |
| **Total proceeds**     | Net proceeds after refunds, taxes, and fees.                        |
| **New users**          | New users who installed and opened your app in the selected period. |
| **Total conv’s**       | All conversions on all paywalls in the selected period.             |
| **Initial conv’s**     | New users who converted on a paywall in the selected period.        |
| **Paywall rate**       | The percentage of new users who saw a paywall.                      |
| **Initial conv. rate** | The percentage of new users who converted on a paywall.             |

Unlike the [key metrics](/docs/dashboard/overview-metrics#key-metrics) on an app's Overview, these cards don't open a chart when you click them. Use the organization [Charts](#organization-charts) page instead.

### Projects table

Below the cards, the projects table lists each project with the same six metrics for the selected date range and environment. Each row also shows the platforms the project has apps on.

* Projects are sorted by **Total proceeds**, highest first. Click any column header to sort by it.
* Type in **Search projects** to filter by project name or app name.
* Click a project to open its dashboard. Superwall opens its iOS app first, then Android, then web, and keeps the date range and environment you picked.
* A project with no apps you can open shows **No available apps** and can't be opened.
* Click **Create project** to add a new project.

### Recent transactions

**Recent transactions** lists the latest transactions from every app you can access, for the selected date range and environment. Each row shows the app it came from, plus the same columns as the [Recent transactions](/docs/dashboard/overview-metrics#recent-transactions) list on an app's Overview.

## Organization charts

The organization **Charts** page has the same chart list, filters, breakdowns, chart formats, and export as an app's [Charts](/docs/dashboard/charts) page. The difference is which apps it reads: all your projects at once, or one project with all of its apps.

![Organization Charts with the scope picker open on All projects above a list of projects, and several charts marked Some apps in the chart list](https://superwall.com/docs/images/organization/organization-charts-scope.jpg)

To chart one project:

1. Click **Charts** in the organization sidebar.
2. Click the scope picker above the chart. It starts on **All projects**.
3. Choose a project.

To go back to every project, choose **All projects** in the same picker. If your access is limited to certain projects, this option reads **All projects you can access**.

When you switch scope, the chart, date range, environment, interval, and breakdown stay the same, unless the new scope doesn't offer that breakdown. Filters that point at one app's paywalls, campaigns, audiences, variants, placements, or products are cleared, since they don't apply to other apps.

### How it differs from app charts

* **App and Project breakdowns.** You can [break down](/docs/dashboard/charts#breaking-down-chart-data) a chart by **App** when it covers two or more apps, and by **Project** when those apps are in two or more projects.
* **Revenue providers.** Each app's revenue is counted from its own revenue source, so an app's numbers match what its own Charts page shows.
* **Some apps.** A chart that only some of the apps can have data for shows **Some apps** in the chart list. Above the chart, a note says how many apps it includes and why. For example, web apps have no installs, so user-based charts leave them out. Advertising charts only include apps with the ad integration.
* **Unavailable.** A chart that none of the apps can show is marked **Unavailable** and explains why instead of loading.
* **One app at a time.** Retention messaging and predicted LTV charts depend on one app's setup, so you can't run them here. Open them from the app's own Charts page.
* **Product duration.** The product duration breakdown and filter only appear when the scope has exactly one app.
* **No annotations.** Annotations belong to one app, so organization charts don't show them. See [Annotating charts](/docs/dashboard/charts#annotating-charts).

## Projects

The **Projects** page is a plain list of every project you can access. Use it when you know where you want to go and don't need the metrics.

![The Projects page with Search projects, Create project, and a list of projects](https://superwall.com/docs/images/organization/organization-projects.jpg)

1. Click **Projects** in the organization sidebar.
2. Type in **Search projects** to filter by project name or app name.
3. Click a project to open its dashboard.

You can also use the arrow keys to move through the list while the search field has focus, and press Enter to open the highlighted project. Click **Create project** to add a new one. To learn how projects group your apps, see [Projects](/docs/dashboard/dashboard-settings/overview-settings-projects).

## Limitations

* Totals, charts, and lists only include projects and apps you have access to.
* The metric cards on the organization Overview don't link to charts.
* Retention messaging and predicted LTV charts aren't available at the organization or project level.

## Related

* [Dashboard Overview and Metrics](/docs/dashboard/overview-metrics)
* [Charts](/docs/dashboard/charts)
* [Projects](/docs/dashboard/dashboard-settings/overview-settings-projects)
* [Access Controls](/docs/dashboard/dashboard-settings/overview-settings-access-controls)