Changelog

What's new at Superwall

Every feature, improvement, and SDK update we ship — across the dashboard, paywall editor, web checkout, integrations, and SDKs.

August 2026

Improvements

  • Stripe Keys for Web Checkout — The Stripe credential field is now labelled "Restricted Key" with clearer setup steps: paste the `rk_live_`/`rk_test_` key Superwall's Stripe app generates for you, no key creation required.
  • Meta Ads Integration — Superwall ad links now run on the `install.link` domain, so allow-list `install.link` in your Meta dataset's traffic permissions to keep Conversions API events flowing.

Improvements

  • Web SDK — The Web SDK is now a first-class Beta option in the SDK navigation and home page, so you can integrate Superwall into a JavaScript or React web app.
  • KMP SDK — The Kotlin Multiplatform SDK now appears as a Beta option in the SDK navigation and home page for teams shipping a shared Kotlin codebase.
  • Vibe Coding — The Vibe Coding guide is now available for the KMP, Unity, and Web SDKs, so AI coding tools can draw on the Superwall docs when integrating on those platforms.

Improvements

  • iOS SDK 4.16.3 — The iOS SDK now compiles cleanly on Xcode 26.0, resolving a build error some teams hit on the latest Xcode.

New Features

  • Meta Ads — Superwall now acts as your mobile measurement partner for Meta, so you can connect Meta, forward purchase events, and attribute installs and revenue back to your ad campaigns without a separate MMP.
  • Advertising Charts — A new Advertising group in the dashboard tracks Ad Spend, ROAS, CPM, CPT, CPP, and Blended CPT, putting paid-acquisition performance next to your revenue data.

Improvements

  • Web Configuration — The web setup guide now shows React and JavaScript side by side with React as the default tab, matching how most web teams integrate.
  • Kotlin Multiplatform Delegate Threading — Clearer guidance for KMP delegate callbacks: treat every callback as potentially background and hop to the main thread for UI so your integrations stay thread-safe.

New Features

  • Dynamic Type Device Attributes — Target paywalls and audiences by a user's system-wide text size with three new device attributes: `fontScale`, `fontSize`, and `preferredContentSizeCategory`.

Improvements

  • iOS SDK 4.16.2 — Localized paywalls no longer flash the default language before rendering, subscriptions now link to the user server-side after purchase or restore, and a range of crash, networking, and reliability fixes ship alongside a Superscript 1.0.15 update.

New Features

  • Web SDK — Run paywalls, placements, and entitlements in the browser using the same campaigns, audiences, and experiments as your mobile apps, with React 19 bindings and server-side entitlement gating.
  • Kotlin Multiplatform SDK — Add Superwall to a Kotlin Multiplatform app through one shared API in your common code that wraps the native iOS and Android SDKs.
  • Share a Superwall AI chat — Share a Superwall AI conversation from the dashboard so your team can pick up the same analysis.

Improvements

  • Web Checkout discount codes — Clarifies when to use Redeem Discount versus Redeem Purchase and points to the Web SDK's programmatic redeemDiscount().

Improvements

  • Superwall Events — The Superwall Events reference now matches what current iOS and Android SDKs emit, adding events like multi-page paywall page views, Stripe web checkout, code redemption, and permission prompts with corrected names and parameters, so the events you forward to your analytics stay accurate.
  • Discount Codes — The web paywall discount tap action is now named Apply Discount (formerly Redeem Discount), and the discount-codes guide is updated to match.

New Features

  • Using Your Own Backend — New guide for teams whose own server handles receipt validation, entitlements, or cross-platform subscription state — forward completed transactions to your backend or take full control with a purchase controller, on iOS, Android, Flutter, and Expo.
  • Expo PaywallView — Embed paywalls directly in your React Native app as an inline view, an overlay, or a modal, with declarative loading, skipped, error, and dismissed states (Expo 1.3.0).

Improvements

  • Android Paywalls & Analytics — Translated paywalls now render in the user's language on first paint instead of briefly flashing the default language, and paywall analytics events gain a per-presentation `presentation_id` plus `close_reason`, `cache_key`, and `build_id` to match iOS (Android 2.8.1).

New Features

  • Realized LTV per new user — A new **Window** control caps how long after install a cohort's revenue still counts (3, 7, 14, 30, 90 days, or unbounded), so every cohort is measured over the same number of days and you can tell whether a pricing or paywall test actually moved LTV.

New Features

  • Discount Codes — Let customers enter a Stripe promotion code on your web paywall, re-price the products in place, and carry the discount through to Stripe checkout — all set up in the paywall editor with the new Redeem Discount action.

New Features

  • Custom Store Products — Attach products from a custom store like Stripe or your own payment backend to Android paywalls; their price, period and trial are pulled from Superwall and purchases route through your own `PurchaseController` instead of Google Play.

Improvements

  • Android SDK 2.8.0 — Moves to Google Play Billing Library 9 (minimum Android version is now 6.0 / API 23) and forwards the system back press into the paywall so multi-page paywalls navigate back a page instead of dismissing.

July 2026

Improvements

  • Android SDK 2.7.23 — Fixes paywall text inputs silently dropping non-Latin keyboards (Cyrillic, Korean, Thai, emoji) and a dead buy button when a cached paywall is re-shown after a purchase, so more users can finish checkout — plus more reliable resolution of non–Play Store purchases.

New Features

  • Superwall AI — A built-in dashboard assistant that answers questions about how Superwall works, what's in your account, and what your data says — in plain English, with links to dig deeper.

New Features

  • Superwall CLI — Manage products, campaigns, and paywalls, query your analytics data, and call the Superwall API right from your terminal or coding agent.

Improvements

  • Superwall Skill — Updated to the new `npx superwall skills` installer and the skills that ship today, so your coding agent stays current.

Improvements

  • Stripe Managed Payments — Clearer setup guidance for web checkout: see when a Stripe environment is Configured and Enabled, how Superwall checks product eligibility before turning Managed Payments on, and how to override Managed Payments per paywall.

New Features

  • Event Tracking Behavior (Expo) — Choose exactly which events Superwall collects — all, Superwall-only, or none — at launch or at runtime, so your app can honor user consent and privacy settings without pulling the SDK.
  • Singular Attribution (Expo) — Pass a Singular device ID through as a typed integration attribute to tie paywall revenue back to your Singular attribution.

Improvements

  • Expo SDK 1.2.0 — Updates the underlying iOS (4.16.1) and Android (2.7.20) SDKs and adds `getStoreFrontCountryCode()` to read the current device's store country.

New Features

  • OneSignal Integration — Sync Superwall subscription state to OneSignal as user tags so your lifecycle and messaging team can segment and branch Journeys on trials, renewals, and cancellations.

New Features

  • Font Size & Font Scale Variables — Adapt paywalls to each device's system text size using the new `Font Size` and `Font Scale` variables, available in the paywall editor and audience filters.

Improvements

  • Android SDK 2.7.21 — Paywalls now survive the app being backgrounded and reopened, concurrent paywalls no longer overwrite each other's experiment ID, and audience-filter evaluation is faster.

New Features

  • Managed Payments — Let Stripe act as merchant of record for eligible Stripe web checkout payments, handling tax calculation and compliance for you through Stripe Connect.

New Features

  • Event tracking controls — A new `eventTrackingBehavior` option lets you decide exactly what the Android SDK sends to Superwall — everything, Superwall-only, or nothing — and switch it at runtime as users update their privacy consent.

Improvements

  • Paywall loading color — Theme the built-in purchase and restore spinner to match your brand with the new `PaywallOptions.loadingColor`.
  • Android SDK 2.7.20 — Adds a `storeFrontCountryCode` property and fixes web-redemption entitlements being dropped from restoration tracking for apps that use a purchase controller.

Improvements

  • iOS SDK 4.16.1 — The iOS SDK now builds cleanly under Xcode 26.4, and setting the OneSignal integration attribute is clarified to use the OneSignal User ID.

June 2026

New Features

  • Monthly Billing Plans for Annual iOS Subscriptions — Offer Apple's monthly billing plan on annual iOS subscriptions and choose per paywall slot whether to present monthly installments or up-front annual pricing.
  • iOS Event Tracking Behavior — New `EventTrackingBehavior` API on iOS 4.16.0 to control SDK event collection (`.all`, `.superwallOnly`, `.none`) at configure time or at runtime for consent changes.

Improvements

  • iOS SDK 4.16.0 — Adds install-attribution matching for performance marketing integrations and fixes a `preloadAllPaywalls` crash and an intro offer eligibility mismatch on upgrades and crossgrades.

Improvements

  • iOS SDK 4.15.4 — Pass Singular's device ID to Superwall with the new `singularDeviceId` integration attribute, so your paywall and subscription data lines up with your Singular attribution.
  • Android SDK 2.7.18 — Adds `singularDeviceId` as an attribution provider, connecting Superwall events to your Singular attribution on Android.

New Features

  • Singular Integration — Forward Superwall subscription and payment events to Singular via server-to-server delivery, with SDID device attribution and revenue tracking.
  • Slider Element — Add a draggable slider to any paywall or onboarding flow to let users pick a number, set a goal, or scrub through progress.

Improvements

  • Android SDK — Fixed an issue where the paywall would not dismiss after a web redemption (2.7.17).
  • Expo SDK — Picked up the latest Android SDK fixes for web redemption handling (1.1.6).

New Features

  • Android SDK — Transaction abandon events are now exposed to paywalls, so you can react to abandoned purchases and recover them right in the paywall.

Improvements

  • Android SDK — Paywalls are more resilient when configuration hasn't finished loading, and popups now display correctly on older Android versions (2.7.16).
  • Expo SDK — Fixes purchase events being dropped on cold start with a custom purchase controller (which could leave the paywall spinner stuck), and adds `shouldShowWebPurchaseConfirmationAlert` to PaywallOptions (1.1.5).

Improvements

  • Setting User Properties — Clear how to unset a user attribute on each platform — pass `nil` on iOS, `null` on Android and Expo — with Expo support for nullable attributes on `expo-superwall` 1.0.5+.
  • Agents Settings — Clarified how your Superwall API key is provided in Agents and when to create an organization key for external tools or scripts, instead of the public SDK key.

New Features

  • AI Chat Builder — Build, refine, and debug paywalls right in the editor by describing what you want in plain language, no app release required.
  • Connect an Agent with MCP — Attach Claude Code, Codex, Cursor, or any MCP-compatible agent to the paywall open in your editor and let it make changes live.

Improvements

  • Expo SDK — The Expo SDK now waits for configuration to finish before triggering, so paywalls present more reliably, plus iOS build fixes and updated deployment-target guidance for Expo SDK 56+.

Improvements

  • Revenue Tracking Settings — Revenue tracking configuration, including your Apple Small Business Program dates, now lives in a dedicated Revenue Tracking settings area, and product setup no longer depends on a RevenueCat public API key.

May 2026

New Features

  • Audit Log — See who changed what across your organization, with filters by actor, action, and outcome plus full before-and-after detail on every request, now in public beta in the new dashboard.
  • Redeem Purchase for Web Checkout — Control where a Web Checkout purchase lands per paywall button, sending buyers to your app default, Superwall's redemption page, a deep link, or your own custom success URL.

New Features

  • Local Resources for Expo — Bundle images and videos in your Expo app so paywalls load them instantly from the device via the `swlocal://` scheme, no remote hosting required.

Improvements

  • Expo SDK — The Expo SDK (1.1.2) now reliably runs your feature callback whenever access is granted — including dismissals of non-gated paywalls — with refreshed underlying Android and iOS versions.

Improvements

  • Android SDK 2.7.15 — Smarter paywall preloading for certain campaign types, clearer periodic price display, and fixes to subscription status and delegate event delivery.

Improvements

  • iOS SDK 4.15.3 — Fixes computed period prices (`weeklyPrice`, `dailyPrice`) being slightly off for products whose subscription period is measured in days, so your displayed per-day and per-week pricing is accurate.

New Features

  • Superwall Agents — A new AI workspace at superwall.ai where growth teams can analyze experiment results, inspect their setup, automate recurring reports, and turn Superwall data into the next test to run.
  • Purchase Outcome Actions — Purchase buttons can now run separate follow-up actions for the success path and the abandon path, so you can recover an abandoned transaction by routing users to a new page, offer, or placement without writing code.

Improvements

  • iOS SDK 4.15.2 — Improves Apple Search Ads attribution capture, filters out the all-zeros IDFA sentinel from attribution payloads, and speeds up package downloads.

New Features

  • Onboarding with Flows — Build first-run onboarding in Flows with branching paths, in-context permission prompts, user attributes, and Flow Journey drop-off analytics, all editable without an app release.

Improvements

  • Apple Retention Messaging — Preview a retention message against an example cancellation screen to check its header, body, locale, image, and alt text before going live.

Improvements

  • Android SDK — Android SDK 2.7.14 fixes test mode products not loading on paywalls, improves retry backoff when Play Services is unavailable, and resolves a date serialization issue in custom info.

New Features

  • Unity SDK — Present Superwall paywalls in Unity mobile games on iOS and Android with a C# API, now documented in a dedicated SDK section (beta).
  • Consumable Products — New step-by-step guides for selling consumables like credits, tokens, and boosts on iOS, Android, Flutter, and Expo, with dashboard setup and how to grant the benefit after purchase.

Improvements

  • Charts — Each dashboard chart now has its own page, so you can jump straight to the metric you care about — proceeds, MRR, trial conversion, paywall conversion, and more.

New Features

  • Query ClickHouse — Run read-only SQL against your organization's analytics data with an API key, so growth teams can build custom reports and dashboards without a separate data warehouse.
  • Adaptive Pricing — Automatically present localized, currency-converted prices in your Stripe web checkout and test them with location-formatted emails before going live.
  • Abandoned Transaction Paywalls — Recover abandoned purchases by binding a paywall drawer to checkout state, surfacing a tailored recovery offer the moment a user cancels the App Store or Google Play purchase sheet.

Improvements

  • Using RevenueCat — The RevenueCat purchase controller example now selects the exact Google Play offer chosen on the paywall, so Android subscription purchases use the right base plan and offer.
  • Migrating to Superwall — New guidance shows how to re-set custom user attributes after migrating, using the original transaction ID to reconnect returning subscribers to their records.
  • Configuring Stripe — Added steps for registering your Apple Pay domain in Stripe so Apple Pay works in your web checkout.

New Features

  • Web Flows — Build web-to-app flows that qualify campaign traffic, personalize the offer, run web checkout, and hand users off to your app, all from Superwall.

Improvements

  • Paywalls & Flows — The Paywalls dashboard is now Paywalls & Flows, so you can view, preview, duplicate, and archive both paywalls and flows in one place.

Improvements

  • Android SDK — Android 2.7.13 fixes a bug where devices using non-Latin numbering systems could be misbucketed in audience-rule version comparisons, and resolves enrichment/subscription request timeouts and a React Native ANR.
  • Expo SDK — Expo 1.1.1 updates the underlying Android version and resolves an ANR when Superwall is used without a provider.

April 2026

New Features

  • Web Funnels — Build web-to-app funnels that qualify paid campaign traffic, personalize the offer, run web checkout, and hand users off to your app, all without an app release.
  • Expo SDK 1.1.0 — Track how users move through multi-page paywalls with the new page-view event, and route custom (non-store) products to your own purchase logic.

New Features

  • Flows Analytics — See exactly how users move through a multi-page flow, where they drop off, and how branches compare, so you can optimize onboarding step by step.
  • Stripe One-Time Purchases — Sell lifetime access, credit packs, and other one-off products through web checkout, with entitlements deciding whether a purchase unlocks ongoing access or is consumed.
  • iOS SDK 4.15.1 — Run a custom callback when fetching a paywall with getPaywall, use asset-catalog images for local resources, and filter audiences on abandoned-transaction product details.

Improvements

  • Priority Placements — Preload your most important campaign's paywalls first, now fully supported on Android, Flutter, and Expo so onboarding and first-launch paywalls are ready instantly.
  • App to Web Checkout — Clarified that Stripe checkout from iOS paywalls opens in an external browser for U.S. storefront customers, in line with Apple's external-purchase-link guidelines.

New Features

  • Custom Store Products — Sell products from outside the App Store on your iOS paywalls by routing checkout through a PurchaseController, with full product variables, trial eligibility, and purchase tracking.
  • Access Controls — Control exactly who can do what across your organization with role-based access, per-project restrictions, a new analytics-only Analyst role, and scoped organization API keys.

New Features

  • Android SDK 2.7.12 — Customer info now flows into paywall info and tracked events, and Stripe and Paddle purchases respect intro offer eligibility on Android.

Improvements

  • Android SDK 2.7.12 — Fixed the dismiss animation for bottom sheets and modals on newer Samsung devices.

New Features

  • Custom Products — Sell products that live outside the App Store: Superwall now routes custom paywall products through your PurchaseController so you can charge them through your own external billing system.

Improvements

  • iOS SDK 4.15.0 — Test-mode products now show their correct trial pricing, and computed weekly/daily/monthly/yearly prices no longer display rounded values (for example, a £4.99/week product showing as £5.00) on StoreKit 2 in production.

Improvements

  • Flutter SDK — Flutter 2.4.12 rolls in the latest iOS and Android SDKs, adds a per-device-tier preload option for paywalls, and surfaces more transaction details to your app.

New Features

  • Consume Google Play Purchases on Expo — Expo apps can now consume an Android purchase token so a consumable item can be bought again, via a new `consume()` method on the compat API.
  • Per-Device Preloading on Android — Override paywall preloading by device tier with `PaywallOptions.preloadDeviceOverrides`, so you can keep preloading on by default but turn it off on low-end devices.

Improvements

  • Android SDK 2.7.11 — Faster SDK startup with less blocking of caller threads, plus fixes for a CookieManager ANR and duplicate `onFinished` calls.
  • Expo SDK 1.0.11 — Adds programmatic `restorePurchases`, a fuller entitlements snapshot, and fixes Superwall callbacks being dropped on first launch before React listeners mount.
  • Intro Offer Eligibility Override — Overriding intro offer eligibility from the Paywall Editor now works on iOS 16 and later, instead of requiring iOS 18.2+.

Improvements

  • Web Checkout FAQ — If your app uses Sign in with Apple, learn how to register Superwall as an authorized email sender so activation links reach customers using private relay "Hide My Email" addresses instead of bouncing.
  • Web Checkout SDK Setup — Clearer end-to-end setup guide, walking through prerequisites, deep links, post-checkout redirecting, testing, and managing memberships.

Improvements

  • Adjust — Configure separate iOS and Android app tokens and map an individual Adjust event token to each of the 14 subscription lifecycle events, with device-level attribution sent straight from your app.

New Features

  • Multi-Page Paywall Tracking (iOS) — A new `paywall_page_view` event tells you how users move between pages of a multi-step paywall and where they drop off, so you can optimize each step of the flow.
  • Multi-Page Paywall Tracking (Android) — The new `PaywallPageView` event reports page name, flow position, navigation type, and time-on-page as users navigate a multi-page paywall, giving you full-funnel insight into your paywall flows.

Improvements

  • Android SDK 2.7.10 — Paywalls no longer dismiss when returning from a deep link, billing errors now surface clearer messages, prioritized preloading is supported, and bottom-sheet rendering is fixed on certain Samsung devices.

New Features

  • Prioritized Placements — Mark a campaign so its paywalls preload before all others, ensuring your most important paywall (like an onboarding or first-launch paywall) is ready to display instantly.

Improvements

  • iOS SDK App Size — Added clear guidance on how much SuperwallKit adds to your iOS app's install size (~7.7 MB), with a link to track the latest number.

New Features

  • Assets — Upload images and videos once into a shared media library and reuse them across paywalls, with discovery to pull in media already used by existing paywalls.

March 2026

New Features

  • Custom Callbacks — Paywalls on iOS can now call back into your app to run logic like input validation or data fetching, then branch on the result — no app release required.

New Features

  • Superwall Skill — Give your AI coding agent live Superwall docs, API access, and step-by-step SDK integration quickstarts for iOS, Android, Flutter, and Expo in a single install.

New Features

  • Appstack Integration — Pass an Appstack identifier from your Flutter app so your Appstack attribution data lines up with Superwall.

Improvements

  • Flutter SDK 2.4.11 — New SuperwallOptions let you observe purchases made outside Superwall, control when the SDK enters test mode, and tune config retries, plus the latest iOS and Android SDK updates.

New Features

  • Adjust Integration — Forward Superwall subscription and payment events to Adjust via the server-to-server API with per-platform tokens and device-level attribution.
  • PostHog Integration — Send subscription and payment events to PostHog with automatic event mapping and revenue conversion to track lifecycle and enrich user profiles.
  • AppStance Integration — Send iOS transaction data with Apple Search Ads attribution to AppStance for Apple Ads ROAS optimization.
  • Appstack Integration — Pass raw Superwall webhook events straight through to Appstack for analytics and attribution.
  • Paywall Tap Animations & Haptics — Add visual tap animations (Shrink, Grow, Fade) and native iOS/Android haptic feedback to any paywall element, no app release required.

Improvements

  • In-App Stripe Checkout — Added App Store review guidance, including suggested reviewer-note language, for offering in-app Stripe checkout to US customers.

New Features

  • Meta Conversion API — Send subscription lifecycle events like renewals, cancellations, and refunds straight to Meta's server-side Conversion API for accurate ad attribution that survives browser privacy limits.

Improvements

  • Facebook Pixel — The Facebook Pixel guide now covers browser-side web paywall tracking on its own and walks you through connecting it from the Web2App integrations area in the dashboard.

New Features

  • Apple Retention Messaging — Configure the message Apple shows on the App Store cancellation screen to win back subscribers who intend to cancel, managed right from Superwall.
  • Local Resources on Android — Bundle images and videos in your Android app so paywalls load them instantly from the device, even on slow connections.

Improvements

  • Expo SDK 1.0.8 — Updated to the latest iOS and Android SDKs and fixed a setup crash so paywalls configure reliably.
  • Android SDK 2.7.8 — Fixed date serialization under R8 and test-mode scope cancellation for more stable paywall delivery.

Improvements

  • Android SDK Changelog — Android SDK 2.7.6 fixes a concurrency issue with early paywall displays and product loading, improves paywall timeout handling, and resolves race conditions in test mode and parameter templating.

Improvements

  • iOS SDK 4.14.1 — Alerts are now localized into 41 languages, free trial eligibility refreshes on every paywall open, and fixes address Stripe trial tracking, web restore prompts, post-refund subscription state, and crossgrade transaction reporting.

New Features

  • Flows — Build multi-page experiences like onboarding, cancellation surveys, and upsell funnels right in the paywall editor, with a canvas view and conditional branching between pages (now in beta).
  • Onboarding Components — New Multiple Choice, Input, and Indicator elements let you capture user selections and input to personalize and branch your flows.
  • Test Mode for iOS — Simulate in-app purchases end to end without StoreKit, including trial overrides and complete/abandon/fail flows, for full paywall testing.

Improvements

  • iOS SDK 4.14.0 — Adds prioritized campaign preloading and Stripe checkout event handling, fixes multiple active entitlement display, and adds Xcode 26.4 beta compatibility.

New Features

  • Local Resources — Point paywall images and videos at media bundled in your app for instant, offline-friendly loading, with an automatic fallback to a remote URL when the local file isn't available.

New Features

  • Appstack Integration — Pass an Appstack integration ID through your user integration attributes on Android and Expo to tie Superwall events back to Appstack.

Improvements

  • Android SDK 2.7.5 — More reliable subscription status: `isActive` is now returned directly instead of calculated from expiration, plus fixes for a webview memory leak, duplicate cleanup work, and test mode interfering with Expo.
  • Expo SDK 1.0.5 — `setUserAttributes` no longer silently fails when an attribute value is `null`, with nullable values now allowed in the TypeScript signatures.

New Features

  • Android Test Mode — Run your entire Android paywall flow end-to-end without any Google Play setup: simulate purchases, free trials, restores, and different entitlement states right from the device.

New Features

  • Android SDK Test Mode — Test your full paywall and purchase flow without Google Play: mark test users in the dashboard (or let it activate automatically) to simulate purchases you can complete, abandon, or fail, with every purchase event firing as usual.
  • Expo SDK Test Mode — Expo apps can now run paywalls in Test Mode, simulating purchases and pulling product data from your Superwall dashboard so you can validate the whole flow without StoreKit or Play Store.

Improvements

  • Android SDK 2.7.4 — Active entitlements are now included on subscription-status-change events, purchases are queried and retried more reliably, transactions expose expiration date, subscription group, and offer ID, and editor pricing rounding is now consistent.

February 2026

New Features

  • Test Mode — Simulate in-app purchases on iOS without StoreKit, letting your team complete, abandon, or fail transactions and fire real purchase events for end-to-end paywall testing.
  • Prioritized Campaign Preloading — Mark a campaign as prioritized in the dashboard and its paywalls preload ahead of all others, so your most important paywalls show first.
  • Custom Callbacks — Respond to paywall actions in your Expo app with the new onCustomCallback handler in usePlacement and useSuperwallEvents.

Improvements

  • Stripe Checkout Events — iOS now emits start, submit, complete, and fail events across the Stripe web checkout flow so you can track the full funnel in your analytics.
  • Firebase Integration — Set your Firebase App Instance ID with the new setIntegrationAttributes API (now including Flutter) so subscription and revenue events land reliably in Firebase Analytics.
  • Android Paywall Events — PaywallClose events now include paywall state and params, and a fix restores subscription status sync when using experimental device variables.

New Features

  • Test Mode — Run your entire iOS paywall flow end-to-end with simulated purchases, restores, and entitlement states — no StoreKit config, sandbox account, or App Store Connect setup required.

Improvements

  • Delay Tap Action — Clarified that the paywall editor's Delay action can drive animation states and create auto-advance timers when chaining actions.

Improvements

  • Flutter SDK — Flutter SDK 2.4.10 refreshes an internal dependency so the SDK stays compatible with the latest Dart analyzer versions.

New Features

  • Android SDK 2.7.1 — Configure paywall options and presentation handlers with a cleaner DSL-style syntax, and trigger haptic feedback directly from paywall actions.

Improvements

  • Android SDK 2.7.1 — Paywall video posters now stay visible during preview, post-purchase loading dismisses correctly when staying on the paywall, and several edge-to-edge and shimmer view warnings and a memory leak are resolved.
  • Flutter SDK 2.4.9 — Updates the underlying iOS SDK to 4.13.0 and Android SDK to 2.7.1.

New Features

  • Web Checkout SDK Setup — Pick your platform — iOS, Android, Flutter, or Expo — and follow a dedicated guide to wire up Web Checkout so customers can buy on the web and have it flow back into your app.

New Features

  • Superwall MCP — Manage your Superwall projects, paywalls, campaigns, and products straight from AI tools like Claude Code, Cursor, and Codex through the Model Context Protocol.
  • Handling Deep Links — Route deep links to paywalls with the `deepLink_open` placement and dashboard campaign rules, so you can change which paywall a link shows without an app release.
  • iOS Changelog — Paywalls now support local images and videos, and trial notifications are scheduled after purchasing Stripe products (4.13.0).
  • Flutter Changelog — Added `onCustomCallback` to the paywall presentation handler, letting you run custom logic and pass data to and from the paywall (2.4.8).

Improvements

  • iOS Changelog — Fixed a race condition on the user ID when upgrading from v3 to v4 and a CocoaPods issue where Superscript wasn't upgraded to 1.0.13 (4.13.0).
  • Flutter Changelog — Updated the underlying iOS and Android SDKs and fixed a bug where identity options passed to `identify()` weren't reaching the native SDK (2.4.8).
  • Expo Changelog — Updated the underlying iOS and Android SDKs, exposed `introOfferToken` on `StoreProduct`, and added several missing SDK events (1.0.2).

New Features

  • Demand Score — See how likely each user is to convert with a 1-100 score assigned on every app open, then target high- and low-intent segments with different offers right from your campaign audiences.
  • iOS Custom Callbacks — Run an async action when a paywall button is tapped and send the result back to the paywall, so you can wire interactive buttons to your own logic without an app release.

Improvements

  • iOS SDK Changelog — The iOS SDK now adds native haptic feedback and post-purchase actions for paywall buttons, microphone and App Tracking Transparency permission prompts, and the Appstack integration attribute, alongside crash and currency fixes.

New Features

  • Custom Callbacks — Paywalls can now trigger app-side logic and branch on the result, so you can validate input or run business logic without rebuilding the paywall flow.
  • Request Permissions from Paywalls — Prompt Android runtime permissions (notifications, location, camera, microphone, and more) straight from a paywall action and branch the UI on the outcome.

Improvements

  • Android SDK 2.7.0 — Paywalls can run a post-purchase action instead of dismissing, one-time purchases with offers are now supported, and this release ships Stripe checkout, redemption, and shimmer fixes.

Improvements

  • Using Referral or Promo Codes — Clarified that presenting your own referral or redemption UI on top of an existing paywall is supported only in the native iOS and Android SDKs.

January 2026

New Features

New Features

  • Intro Offer Eligibility Override — Override intro offer eligibility on iOS even with your own PurchaseController by passing Superwall's generated JWS token to StoreKit when purchasing.

New Features

  • Set Attribute Paywall Action — Set user attributes straight from a paywall tap to capture survey answers and segment users for A/B tests, no code or app release required.
  • Trial Reminder Timing — Trial-ending notifications now fire relative to when the trial actually ends, so reminders land at the right moment regardless of the product's trial length.

Improvements

  • Paywall Editor — Copy and paste components directly on the live preview canvas with the standard keyboard shortcuts.
  • Get Started with AI — Spin up Superwall faster using our MCP and prompts, surfaced right from the overview dashboard.
  • Figma Plugin — Clarified that Figma files need Auto Layout for the one-click paywall import to work.

Improvements

  • Flutter SDK — Flutter 2.4.7 brings the latest iOS and Android SDKs and richer transaction details, so you can see which store fulfilled each purchase, what offer was applied, and react to user attribute changes as they happen.

New Features

  • Overriding Introductory Offer Eligibility — Decide right in the Paywall Editor who sees free trials and intro offers — show them to returning users for win-backs or hide them entirely, no app release required.

New Features

  • Expo SDK 1.0.1 — The Expo SDK reaches 1.0 with new configuration options, richer web checkout data, and Android back-button handling, all without an app release.
  • Web Checkout Product Data — Successful web purchases now return the exact product, localized price, currency, and trial details so you can show accurate confirmation screens and pass clean data to your billing system.
  • Android Back Button Handling — Intercept rerouted Android back presses on a paywall to show exit confirmations, capture analytics, or pause before dismissing.

Improvements

  • Configuring Superwall on Expo — New options let you observe purchases made outside Superwall, tune config retries, skip the App Store account prompt for testing, and mock Play Store reviews in development.

New Features

  • Article-Style Paywalls — Embed an inline paywall inside a scrollable article on iOS, then open a full-screen paywall with more plans when a reader taps to see all options.

New Features

  • Facebook Pixel — Send subscription events server-side to Meta's Conversion API for accurate Facebook and Instagram ad attribution that isn't blocked by browsers or ad blockers.
  • Customer.io — Stream subscription lifecycle events into Customer.io to trigger messaging campaigns and build segments around trial, renewal, and churn behavior.
  • Discord — Get real-time, color-coded subscription notifications posted straight to your Discord channels via webhooks.

Improvements

  • Stripe Setup — Connect Stripe to your web checkout by installing the official Superwall Stripe app, which provisions the right keys and permissions automatically instead of creating a restricted API key by hand.

New Features

  • Figma Plugin — Turn any Auto Layout Figma frame into a fully editable Superwall paywall in one click, with each component imported individually and multi-frame designs assembled into multi-page paywalls.

New Features

  • Request permissions from paywalls — Add a Request permission action to any paywall element on iOS to prompt for notifications, location, photos, contacts, or camera access without sending users to Settings, and track the outcome with new permission events.
  • Community SDKs — A new Community SDKs section documents how to add Superwall to Capacitor apps using the community-maintained Capawesome plugin.

Improvements

  • iOS SDK 4.12.0 — Adds paywall preloading events you can observe, rounds drawer paywall corners to match the device radius, and fixes app-version comparisons in audience rules.
  • Standard Placements — Each standard placement now documents the parameters it carries, so you can target paywalls more precisely when building audience filters.
  • StoreKit testing on Expo — Expanded Expo guidance for testing purchases with a development build, plus a new fix for paywalls autorotating on Android.

December 2025

New Features

  • Vibe Coding Guide — Drop a single all-in-one prompt into your AI coding assistant to install, configure, and present your first Superwall paywall, now tailored per platform for iOS, Android, Flutter, Expo, and React Native.

New Features

  • SDK Changelogs — Full release notes for the iOS, Android, Flutter, Expo, and React Native SDKs now live in the docs, so you can see exactly what changed in every version in one place.
  • Superwall Deep Links — New guide for using Superwall Deep Links to trigger a paywall or custom in-app behavior from a link, now covering iOS, Flutter, and Expo.
  • getPresentationResult — New reference docs for checking whether a placement would show a paywall, a holdout, or fail, without actually presenting anything — available for iOS, Android, and Expo.
  • Setting a Locale (Expo) — Override the device locale in the Expo SDK to preview localized paywalls, QA market-based targeting, and capture screenshots in any language.
  • StoreKit Testing — Step-by-step StoreKit testing guides are now available for the Flutter and Expo SDKs, so you can test purchases locally without hitting App Store servers.

Improvements

  • iOS SDK 4.11.2 — Latest iOS SDK release, with new reference pages for refreshing configuration, subscription and non-subscription transactions, and customer info.
  • Placement Parameters — New section documenting the parameters available on placements and how to use them in your campaign rules and paywalls.
  • Web Checkout Activation Emails — Clarified that Superwall emails the customer an activation and redemption link after web checkout, including how to disable it.

New Features

  • Subscription Status — Flutter apps can now check whether a user is subscribed with a simple `isActive` property instead of comparing enum cases.
  • Paywall Options — A new `onBackPressed` callback lets Android apps respond when someone taps the system back button on a paywall.

New Features

  • Webhooks — Webhook payloads now include the custom user attributes you set via the SDK, so you can tie subscription and payment events back to your own user data.

New Features

  • Support Center — A new searchable Support Center with FAQs, troubleshooting guides, and how-tos covering the dashboard, paywall editor, SDKs, and web checkout, so you can self-serve answers in one place.
  • Web-Only Checkout — Run Superwall web checkout with no mobile app: use Redirect mode to send buyers to your own URL with purchase data, for web apps, SaaS, or any non-App-Store product.
  • Firebase — A new Firebase integration sends Superwall subscription and payment events straight to Firebase Analytics (GA4), with ecommerce revenue tracking, store attribution, and separate production and sandbox streams.

Improvements

  • iOS SDK — iOS 4.10.8 adds integration attributes for passing attribution identifiers and clarifies how deep-link handling behaves before configuration finishes.
  • Android SDK — Android 2.6.5 brings new Superwall and paywall options along with web-checkout post-checkout redirect handling.
  • Flutter SDK — Flutter 2.4.5 expands the SDK reference with customer info, entitlements, integration attributes, and presentation result APIs.
  • Expo SDK — Expo 0.8.1 documents new provider, loading, error, and user components for a clearer setup experience.

New Features

  • Expo SDK — New `SuperwallError` and `SuperwallLoaded` components let you render fallback UI when Superwall fails to configure or finishes loading, plus a web purchase confirmation option.
  • Flutter SDK — Read a customer's full subscription and entitlement state directly in your app with new `CustomerInfo`, `Entitlements`, and `IntegrationAttribute` APIs.
  • Android SDK — New `consume()`, `showAlert()`, and `setIntegrationAttributes()` methods, plus access to the redeemed product identifier after web checkout.

Improvements

  • iOS SDK — Pass a Firebase installation ID through integration attributes and updated deep link handling.

New Features

  • Customer Info — Read a user's full purchase and subscription history on iOS, and react in real time to subscription changes via Combine, an async stream, or a delegate.
  • Grant Entitlements — Manually grant or revoke any entitlement for a user right from the dashboard to unlock pro access, handle support, and more.
  • Integration Attributes — Pass user IDs from analytics tools like Amplitude and Mixpanel to Superwall on iOS to keep attribution joined up across your stack.

Improvements

  • Campaign Audiences — Target campaigns by subscription status, including users who cancelled a trial, turned off auto-renew, or whose entitlements have expired.

November 2025

New Features

  • Expo Debugging Guide — A new troubleshooting guide for the Expo SDK that walks through fixing the "Cannot find native module 'SuperwallExpo'" error, regenerating native folders, EAS development builds, clearing stale caches, and version compatibility.

New Features

  • React Native SDK Reference — Full API reference for the React Native SDK is now documented, covering configure, register, identify, subscription status, the purchase controller, delegate callbacks, and all options and types.

Improvements

  • Android SuperwallOptions — Documented the `passIdentifiersToPlayStore` option so you can choose whether Google Play receives the raw user ID or a hashed value when correlating purchases, with the same guidance added for Flutter and Expo.

New Features

  • In-App Stripe Payment Sheet Checkout — Run Stripe web checkout for US customers inside your app with a native-feeling bottom payment sheet, configurable right from the paywall editor with no app release.

Improvements

  • Linking Web Purchases to RevenueCat — The RevenueCat redemption examples now surface non-200 responses and network errors across iOS, Android, Flutter, and Expo so you can add retries, alerting, or user messaging in production.

New Features

  • Product Overrides — Swap the products shown on a paywall on the fly to A/B test tiers, run promo pricing, or target user segments, without touching the paywall design in the dashboard.

New Features

New Features

  • Web Checkout Locations — Choose how web checkout (Stripe or Paddle) is presented to buyers: an in-app payment sheet, an in-app browser, or the system browser — all configured in the paywall editor.

New Features

  • Making Purchases — Purchase any StoreKit product on iOS with a single call, with or without a paywall, and respond to the result.
  • Request Review — Add a tap action in the paywall editor that triggers the system rating prompt or deep-links to a written App Store review.
  • Account Management — Manage your dashboard profile, two-factor authentication, connected Google/GitHub accounts, and passkeys from one settings page.

Improvements

  • Using RevenueCat with Expo — The RevenueCat example now returns clear cancelled and failed purchase results instead of throwing, so paywalls handle outcomes correctly.
  • Advanced Configuration — The purchase controller example now keeps subscription status in sync with customer info changes and reconciles both device and web entitlements.

New Features

  • Verify Webhook Requests — Confirm that incoming webhooks genuinely come from Superwall and weren't tampered with, using your endpoint's signing secret to validate signatures and block replay attacks.

New Features

  • Stripe Checkout Prefill — Pass a Stripe customer ID as a user attribute to prefill saved payment methods and customer info when sending shoppers from an iOS paywall to Stripe checkout.

October 2025

Improvements

  • Webhooks — Verify webhooks and analytics integrations with real sandbox transactions (TestFlight sandbox Apple ID, Play Store license test accounts, Stripe Test Mode); the synthetic `test` event is no longer sent.

New Features

  • Web Checkout: Post-Checkout Redirecting — Bring users back into your app after a web purchase with full guides for Android, Expo, and Flutter, covering Redeem and Redirect modes, RevenueCat, and your own purchase controller.

New Features

  • Onboarding Flows — Build multi-page onboarding experiences from the dashboard using paywalls, targeting rules, and dynamic content, and iterate on them without shipping an app update.
  • Tracking Subscription State — Read and react to a user's live subscription status and entitlements on Android, Flutter, and Expo to gate premium features in your own UI.
  • RevenueCat + Web Checkout for Flutter — Link web paywall purchases back to RevenueCat in your Flutter app using deep-link redemption and delegate methods.
  • Targeting by User Properties & Placement Parameters — Reference your own user attributes and placement parameters directly in campaign audience filters to target exactly who sees a paywall.

Improvements

  • Device Tier Targeting — Device tier filters now support both `contains` for matching a range of device capabilities and `equals` for targeting one exact tier.
  • Paywall Variables — Period-length variables now localize automatically, so subscription terms display correctly across languages without manual setup.

Improvements

  • Identity Management — The `userId` you pass to `identify` must be a valid UUID on iOS, or StoreKit rejects it for `appAccountToken` and falls back to the anonymous alias — keeping the identifier in your App Store Server Notifications stable and predictable.
  • Products — Added step-by-step guidance for tagging a Google Play offer with `sw-ignore-offer` so it's excluded from automatic best-offer selection.

New Features

  • Web Checkout Post-Purchase Behavior — Choose what happens after a web purchase: let Superwall handle redemption automatically, or redirect buyers to your own URL with their purchase details so you can run custom success, onboarding, or verification flows.

New Features

  • Paddle for Web Checkout — Run web purchase funnels through Paddle as an alternative to Stripe (private beta), with a full setup guide for keys, redirect URLs, and sandbox configuration.

Improvements

  • Google Play Revenue Tracking — Google Play revenue tracking is now generally available in Settings, no longer limited to private beta.
  • Using RevenueCat with Flutter — Updated the RevenueCat purchase controller sample for the purchases_flutter v9 API so Flutter integrations keep working on the latest SDK.

New Features

Improvements

  • Drawer Presentation Options — Configure the bottom-drawer presentation style with a custom height, corner radius, and optional scrolling.
  • Device Preview — Preview paywalls on an iPhone XL size that reflects Max and Plus device families.

New Features

  • Android App Links for Web Checkout — Let users who buy on the web land back in your Android app and redeem their purchase automatically through verified app links.
  • Team Roles — Assign Owner, Admin, Editor, or Reader roles so the right people can build paywalls and run tests while sensitive settings stay locked down.
  • Back Button Rerouting — Run your own logic on a paywall back press and decide whether to consume the event, configurable right in the paywall editor.

Improvements

New Features

  • Team Roles & Permissions — Assign Owner, Admin, Editor, or Reader roles to control who on your team can build paywalls and campaigns, manage members, or see sensitive settings.

Improvements

  • Web Checkout — Added troubleshooting guidance for helping users who paid on the web regain access to their subscription via your plan management page.

New Features

  • Subscription Management — See how Superwall keeps subscription state in sync across the App Store, Play Store, and web checkout, and where that data surfaces across the dashboard, campaign targeting, and integrations.

Improvements

  • Users — The user profile now surfaces a full per-user journey at a glance: revenue events and conversions, SDK event breadcrumbs, active entitlements, and Apple Search Ads attribution, all in one place.

Book a demo

Tell us a little about your app and we'll match you with the right person.

  • A personalized walkthrough of the paywall builder
  • Guidance on your monetization and pricing strategy
  • Custom implementation recommendations for your stack
  • A look at proven paywall templates
  • Revenue-optimization best practices

Ship your next paywall today

Start for free