Changelog
Track recent updates and additions to the Superwall documentation.
February 2026
iOS SDK → Guides
Android SDK → Guides
Flutter SDK → Guides
Expo SDK → Guides
Dashboard → Settings
Support
- Learn how to reset A/B test assignments or create a new campaign for clean paywall metrics.
- Explains the legacy User role in team settings and recommends current role assignments.
- Explains why the "SDK releases behind" warning persists after updating the SDK version.
- Learn how to localize paywall text using dynamic values based on device language.
Support → FAQ
Support → Troubleshooting
iOS SDK
iOS SDK → SDK Reference
Dashboard
Android SDK
Android SDK → Quickstart
Android SDK → SDK Reference
- Adds new `timeoutAfter` configuration to control paywall loading timeout duration.
PaywallOptions
Update - Adds reactive customer info observation using StateFlow with immediate snapshot support.
Superwall
Update - Adds new delegate methods for tracking customer info and user attribute changes.
SuperwallDelegate
Update - Adds details about new Superwall events, deprecations, and example event handling in Android SDK.
SuperwallEvent
Update - Updates Android SDK version reference to 2.7.0.
Overview
Update
Documentation
Integrations
- Clarifies Auto Layout requirement applies to entire Figma frame during import.
Figma Plugin
Update - Removed Paddle payments from platform list in Amplitude event integration guide.
Amplitude
Update - Removed references to Paddle and updated store descriptions for payment events.
Integrations
Update - Removes Paddle references and updates webhook store field descriptions for clarity.
Webhooks
Update
Dashboard → Creating Paywalls
Web Checkout
- Removes Paddle beta references and focuses exclusively on Stripe product creation steps.
Creating Products
Update - Removes Paddle references and streamlines web checkout setup instructions for Stripe integration.
Overview
Update - Clarifies Stripe setup steps and removes Paddle unsupported note for web-only checkout.
Web-Only Checkout
Update
January 2026
Support → FAQ
Support → Troubleshooting
Support
Android SDK → SDK Reference
- Removes `timeoutAfter` option from PaywallOptions SDK configuration for Android.
PaywallOptions
Update - Adds new `userAttributesDidChange` method to track changes in user attributes.
SuperwallDelegate
Update - Updates PaywallOptions reference with new TypeTable format and enhanced parameter descriptions.
PaywallOptions
Update - Updates PurchaseController reference with new TypeTable layout for clearer method parameter descriptions.
PurchaseController
Update - Updates `SuperwallOptions` reference page with enhanced TypeTable for detailed configuration parameters.
SuperwallOptions
Update - Replaces parameter table with TypeTable component, adding required field indicators.
PaywallBuilder
Update - Updates `setSubscriptionStatus()` parameter table to use TypeTable component for clarity.
setSubscriptionStatus()
Update - Updated Android SDK configuration method with new ActivityProvider parameter and Result-based completion handler.
configure()
Update - Updates parameter table with new TypeTable component for getPresentationResult() method.
getPresentationResult()
Update - Updated parameter table format for `handleDeepLink()` method using TypeTable component.
handleDeepLink()
Update - Replaces parameter table with TypeTable for improved clarity on `identify()` method parameters.
identify()
Update - Updates `register()` method reference with improved TypeTable for clearer parameter descriptions.
register()
Update - Updates user attributes parameter table with improved TypeTable component and description.
setUserAttributes()
Update
iOS SDK → Guides
- Updated guides for iOS SDK
- Clarifies additional requirement for App Store Connect API setup for intro offer eligibility.
- Adds note about upcoming **Request permission** action in paywall editor rollout.
- Learn how to embed inline paywalls in scrollable articles with optional full-screen plans.
- Explains how to set up local StoreKit testing environment for in-app purchases in Xcode.
Flutter SDK → SDK Reference
- Updates restore failure message description and default text for clarity.
PaywallOptions
Update - Added reference for non-subscription transactions, including properties and usage examples.
- Adds detailed reference for subscription transactions with new offer and store properties.
- Adds new `userAttributesDidChange` method to SuperwallDelegate for tracking user attribute updates
SuperwallDelegate
Update - Updates Superwall Flutter SDK reference page to version 2.4.7.
Overview
Update - Clarifies `SuperwallDelegate` behavior when setting user attributes in Flutter SDK.
setUserAttributes()
Update - Improves CustomerInfo reference with enhanced table format and clarified property details.
CustomerInfo
Update - Describes Entitlements properties using a new TypeTable component for clearer presentation.
Entitlements
Update - Removes detailed table of integration attribute values from IntegrationAttribute reference page.
IntegrationAttribute
Update - Improves PaywallPresentationHandler reference with enhanced TypeTable and parameter details.
- Removes detailed cases table for PresentationResult, replaced with placeholder TypeTable component.
PresentationResult
Update - Updates PurchaseController parameter table to use TypeTable component with more structured information.
PurchaseController
Update - Replaced table with detailed TypeTable for SuperwallOptions parameters with more context and defaults.
SuperwallOptions
Update - Updated parameter table format to improve readability and clarity for setSubscriptionStatus().
setSubscriptionStatus()
Update - Updates `configure()` parameter table with a new TypeTable component for improved readability.
configure()
Update - Updates consume() parameter table to use TypeTable component for clearer presentation.
consume()
Update - Updates parameter table to use TypeTable component with clearer, more structured parameter descriptions.
getPresentationResult()
Update - Updates `handleDeepLink()` reference to use TypeTable for clearer parameter documentation.
handleDeepLink()
Update - Updates identify() method reference with improved TypeTable component for parameter details.
identify()
Update - Updates reference page to use TypeTable component for parameter description.
overrideProductsByName
Update - Replaces parameter table with more detailed TypeTable for registerPlacement() function parameters.
registerPlacement()
Update - Updated parameter table format with improved type definition and clarity.
- Updates parameter table to use TypeTable component for clearer attribute documentation.
Expo SDK → SDK Reference
- Adds new `onUserAttributesChange` event handler for tracking external user attribute updates.
useSuperwallEvents
Update - Describes how to consume rerouted Android back buttons in SuperwallProvider with custom handling.
SuperwallProvider
Update - Updates SDK reference to latest version v1.0.1.
Overview
Update - Clarifies how to handle purchase and restore outcomes in the CustomPurchaseControllerProvider.
- Updates SuperwallError component props section with improved type and description clarity.
SuperwallError
Update - Adds TypeTable to describe the `children` prop with type and requirement details.
SuperwallLoaded
Update - Adds prop details for SuperwallLoading component, explaining required children prop.
SuperwallLoading
Update - Updates `getPresentationResult()` reference with new `TypeTable` component and detailed result types.
getPresentationResult()
Update - Improves usePlacement hook documentation with new TypeTable component and detailed state descriptions
usePlacement
Update - Updated `useSuperwall` hook reference with improved type details and configuration options.
useSuperwall
Update - Adds detailed type definitions and descriptions for all `useUser` hook returned values.
useUser
Update
Dashboard → Creating Paywalls
- Learn keyboard shortcuts for copying and pasting components in the paywall editor.
Layout
Update - Clarifies how trial-end notifications work across different trial lengths and SDK versions.
Notifications
Update - Describes new `Set Attribute` tap action for capturing user preferences and tracking engagement.
Styling Elements
Update
Integrations
- Highlights requirement of Auto Layout in Figma files for successful paywall design import.
Figma Plugin
Update - Introduces comprehensive guide for integrating Superwall events with Customer.io's Data Pipelines API.
Customer.io
New - Adds comprehensive Discord integration guide with setup, configuration, and webhook creation steps.
Discord
New - Introduces Facebook Pixel integration guide with comprehensive configuration and tracking options.
Flutter SDK
Expo SDK
Expo SDK → Guides
iOS SDK → SDK Reference
- Added note about upcoming Request permission action in paywall editor for iOS SDK.
SuperwallEvent
Update - Replaces table with more detailed TypeTable component for NonSubscriptionTransaction properties.
- Provides detailed configuration options for customizing paywall interactions and alerts in iOS SDK.
PaywallOptions
Update - Replaces table with TypeTable for PaywallPresentationHandler method descriptions and types.
- Updated PurchaseController reference to use TypeTable for clearer parameter descriptions.
PurchaseController
Update - Updated SubscriptionTransaction properties table with more detailed type and requirement information.
SubscriptionTransaction
Update - Updates SuperwallDelegate reference with more detailed method type and parameter information.
SuperwallDelegate
Update - Updates SuperwallOptions reference with new TypeTable and clarified StoreKit, transaction check details.
SuperwallOptions
Update - Improves getPaywall method reference with detailed parameter descriptions and TypeTable.
getPaywall()
Update - Replaces markdown table with TypeTable component for clearer parameter descriptions and formatting.
configure()
Update - Updated CustomerInfo reference with more detailed property descriptions and TypeTable.
customerInfo
Update - Updates entitlements section with new TypeTable component and consistent property descriptions.
entitlements
Update - Updated parameter table format for getPresentationResult() method using TypeTable component.
getPresentationResult()
Update - Updated handleDeepLink method documentation with improved parameter type definition and clarified return value.
handleDeepLink()
Update - Updated parameter table format for identify() method with improved type description.
identify()
Update - Replaces parameter table with TypeTable for clearer, more structured register() method documentation
register()
Update - Updates parameter table to use TypeTable component with clear attribute definition.
setIntegrationAttributes
Update - Updates parameter table format and clarifies setUserAttributes method details for iOS SDK.
setUserAttributes()
Update - Updates SDK reference page with latest Superwall iOS SDK version 4.12.0.
Overview
Update
Web Checkout
- Provides detailed, illustrated steps for configuring Stripe keys in Superwall with live and test modes.
Stripe Setup
Update - Added link to Superwall Stripe app in Stripe configuration instructions.
Web Checkout Links
Update - Clarifies web checkout setup by specifying installation of Superwall Stripe app.
App2Web
Update - Added Stripe app installation guide and clarified Paddle setup steps for Web Checkout.
Overview
Update
Flutter SDK → Guides
React Native SDK → SDK Reference
- Updates PaywallOptions reference with more detailed type descriptions and new TypeTable component.
PaywallOptions
Update - Updates SDK reference table to TypeTable for PaywallPresentationHandler method details.
- Updated PurchaseController reference with improved method type definitions and table layout.
PurchaseController
Update - Updated SuperwallDelegate reference with detailed TypeScript method signatures and descriptions.
SuperwallDelegate
Update - Replaces parameter table with more detailed TypeTable for SuperwallOptions properties.
SuperwallOptions
Update - Updates configure() method reference with improved TypeTable component and parameter descriptions.
configure()
Update - Updates parameter table style and confirms `url` parameter is required for `handleDeepLink()`.
handleDeepLink()
Update - Updates identify() method reference with improved TypeTable component for clearer parameter descriptions.
identify()
Update - Updates register() parameter reference to use TypeTable for clearer, more structured parameter descriptions.
register()
Update - Updates parameter table formatting for setUserAttributes() method reference.
setUserAttributes()
Update - Updates component reference for `setSubscriptionStatus` method using new TypeTable component.
Subscription Status
Update
Dashboard → Campaigns
iOS SDK
December 2025
iOS SDK
Android SDK
Flutter SDK
Expo SDK
React Native SDK
iOS SDK → Guides
iOS SDK → SDK Reference
- Adds guidance on when and how to reset user state with `Superwall.shared.reset()`
Superwall
Update - Deprecates `isApplePayAvailable` attribute, which now always returns `true`
getDeviceAttributes
Update - Explains how to manually refresh Superwall configuration during development workflows.
- Demonstrates accessing Firebase installation ID from integration attributes.
integrationAttributes
Update - Adds reference for confirming experiment assignments on iOS with code examples.
- Adds async method for retrieving customer information with examples in Swift.
Android SDK → SDK Reference
Flutter SDK → Guides
Flutter SDK → SDK Reference
- Added guidance on resetting user state and best practices for SDK user management.
Superwall.shared
Update - Adds example for checking subscription status and using the `isActive` convenience property.
subscriptionStatus
Update - Adds reference for retrieving customer info, subscriptions, and entitlements in Flutter SDK.
- Introduces `getEntitlements()` method for retrieving and filtering user's subscription entitlements.
Expo SDK → Guides
Expo SDK → Quickstart
React Native SDK → SDK Reference
Dashboard → Campaigns
Dashboard → Settings
Dashboard
Web Checkout
Support
- Describes default activation email details for web checkout, including sender and subject.
- Troubleshooting guide for paywall editor menus or modals closing unexpectedly in web browsers.
- Added instructions for changing login email address by creating a new account
- Explains how to update Apple Small Business Program status in Superwall dashboard.
- Explains why trial conversion and cancellation rates don't always sum to 100%.
- Added video tutorial explaining how to use free revenue charts for tracking app proceeds.
- Learn how to break down revenue data by user attributes in Superwall with this video tutorial.
- Explains how Superwall calculates Estimated ARPU metric using trial proceeds and user count.
- Provides step-by-step instructions for finding Superwall Server Secret for RevenueCat integration.
- Learn how to optimize refund protection settings to prevent unauthorized app refunds.
- Provides video walkthrough for configuring products in Superwall using App Store Connect or Revenue Cat.
- Learn how to show different paywalls to users based on audiences in Superwall.
- Added video tutorial and guide for integrating Apple Search Ads with Superwall analytics.
- Added instructions for adding VAT number to invoices in Billing Settings.
- Learn how to recreate an archived product in Superwall when direct unarchiving is unavailable.
- Clarifies the difference between "Trial Cancel" and "Trial Expire" tags in user subscriptions.
- Introduces a video product tour covering Superwall features for new users and developers.
- Explains the difference between initial conversion and new trials metrics in Superwall analytics.
- Provides overview of Superwall Dashboard for managing paywalls, campaigns, and users.
Dashboard
New - Introduces new Support Center with common issues, troubleshooting links, and help options
- Explains how to create countdown timers for paywalls using Superwall's editor through video tutorial.
- Provides video tutorial and guidance on adding products to paywalls with customization tips.
- Added details about automatic video and image compression when uploading to a paywall.
- Adds video tutorial for building first paywall with step-by-step walkthrough from start to testing.
- Added video tutorial for setting up referral systems with custom actions in Superwall SDK.
- Added guidance on pricing limitations for non-subscription products in paywall editor.
- Learn how to set up and use custom actions in your paywall with a helpful video tutorial.
- Learn how to show discounted paywalls for abandoned transactions and boost revenue.
- Learn how to track specific paywall interactions using custom placements with this video tutorial.
- Learn how to display dynamic images in paywalls using contextual variables.
- Explains feature gating in Superwall, demonstrating how to control paywall and pro content access.
- Learn how to customize paywalls based on device, mode, and screen width in Superwall.
- Learn how to create multi-tier paywalls with different service levels using the Superwall Editor.
- Learn how to animate text and elements using Lottie and Effects in Superwall editor.
- Learn how to use dynamic values to customize paywalls based on user conditions and device.
- Provides video tutorial on tracking user interactions and behavior on paywalls
- Provides detailed steps for copying paywalls between Superwall accounts using sharing feature.
- Added guide for updating existing snippets instead of creating new ones
- Learn how to generate AI images for paywalls, banners, and icons with Superwall's new feature.
- Learn how to use the Superwall Paywall Editor to create and manage paywalls.
- Explains how to set up sandbox testing without affecting production metrics in Superwall SDK.
- Demonstrates presenting a paywall on first user touch instead of app launch.
- Adds quick video tutorial for installing and configuring Superwall SDK in Flutter projects.
- Explains how to control web restoration alert behavior in Superwall SDK configuration.
- Demonstrates how to present paywalls in iOS apps using Superwall's event-driven SDK approach.
- Added video tutorial on using Xcode's Transaction Manager for testing subscription states.
- Explains how to disable Streamlined Purchasing feature for iOS apps using StoreKit APIs.
- Added video tutorial for installing Superwall's SDK into iOS apps using Swift Package Manager and Cocoapods.
- Added video tutorial demonstrating how to make first purchase using Superwall in iOS app.
- Added SDK integration overview with comprehensive guide for developers.
SDK
New - Introduces video tutorial demonstrating web checkout flow for iOS using Superwall and Stripe.
- Added troubleshooting guide for resolving Stripe Portal loading errors in web2app environment.
Why am I seeing "An error occurred while loading the Stripe Portal" in the manage subscription page?
New - Added guide for integrating Superwall Web Checkout into applications.
Web Checkout
New
Support → FAQ
- Added FAQ explaining how to pre-fill email for subscription management page.
- Added guide for migrating existing purchases to RevenueCat with Superwall support.
- Explains why Android apps lack historical revenue data when integrating Google Play
Why is my Android app missing historical revenue data after setting up the Google Play integration?
New - Explains common causes and strategies for reducing transaction failure rates in mobile apps.
- Provides comprehensive guide for migrating subscriptions from other providers to Superwall
- Added guide explaining how to transfer an app to a new owner through Superwall support.
- Introduces Superwall's new pricing model based on Monthly Attributed Revenue (MAR)
- Added FAQ section with common questions and answers about Superwall.
FAQ
New
Support → Troubleshooting
- Explains why trials can remain pending and how Apple's billing retry process works
- Explains why an active subscription might not show data in the Superwall dashboard.
- Added troubleshooting guide for resolving paywall update and visibility issues in Superwall.
- Explains troubleshooting steps for free trial and introductory offer visibility in paywalls.
- Added troubleshooting guide for common Android SDK integration and support issues.
- Provides troubleshooting steps for RevenueCat transaction attribution issues in Superwall paywalls
- Explains how to handle billing issues when a free trial ends on App Store platforms.
- Explains how to correctly set user IDs in webhooks for accurate transaction tracking and attribution.
- Explains troubleshooting steps for missing webhook events when using RevenueCat with Superwall.
- Troubleshoots webhook event configuration and testing for App Store integrations
- Provides troubleshooting guidance for paywall presentation, subscription status, and iOS testing.
- Explains how to resolve "Sign in to Apple Account" alerts when testing in-app purchases.
- Provides comprehensive troubleshooting guide for resolving paywall presentation and configuration issues.
- Added troubleshooting guide for common Flutter SDK integration issues and support resources.
- Explains 520 errors in Superwall's events API, why they occur, and how to handle them.
- Explains how to resolve PlacementNotFound errors when using placements in Expo.
- Added troubleshooting guide for resolving inactive subscription status after purchase.
- Added troubleshooting guide for common iOS SDK integration and usage issues.
- Explains how to resolve "Missing App ID" warning when integrating App Store Connect API with Superwall.
- Explains how to resolve "Unknown" product status issues in Superwall dashboard.
- Added troubleshooting guide for Android paywall loading issues with billing service errors.
- Added troubleshooting support page with automatic listing of support resources.
- Provides comprehensive troubleshooting steps for resolving iOS product loading issues in-app.
- Added troubleshooting steps for resolving product loading issues on Android.
- Provides troubleshooting steps for loading products in iOS Simulator using StoreKit config files
- Provides troubleshooting steps for loading products with StoreKit configuration files on iOS.
- Added troubleshooting guidance for products not loading in browser previews.
- Added troubleshooting guide for resolving products not loading across platforms.
Flutter SDK → Quickstart
Integrations
Android SDK → Quickstart
How is this guide?
Edit on GitHub