Repository navigation
Releases
Releases · superwall/Superwall-iOS
4.19.1
Enhancements
- Adds watchOS 8+ and tvOS 15+ support through Swift Package Manager, for purchases, subscription status, entitlements, user attributes and events. Paywalls can't be shown there, so when one would show,
registerruns non-gated features and returns an error for gated ones.
Fixes
- Placements named after a standard Superwall event are now rejected by
getPaywallandPaywallViewtoo, andregisterreports this to its error handler instead of silently doing nothing. - Fixes setting a
$-prefixed attribute from a paywall deleting the existing attribute with the same name. Keys beginning with$are reserved, so they're now ignored. - Fixes
reset()leaving the new user's attributes withoutaliasIdandseed, so audience filters on them didn't match. - Fixes
reset()occasionally deleting the new user's alias and seed from disk, giving them another alias on the next launch. - Fixes the seed derived from the user ID being applied to a user who had since logged out or switched.
- Fixes
reset(), andidentify(userId:)switching user, sending severaluser_attributesevents for one change. The new user's Apple Search Ads, MMP and install-scoped integration attributes are now in place when the call returns. - Fixes config refreshes being able to run at the same time and apply their configs out of order. A refresh called while the launch config fetch is still finishing now waits for it.
- Fixes
Superwall.shared.configurationStatusstaying.pendingwhen the config couldn't be fetched. It's now.failed. - Fixes
getCustomerInfo()never returning when the SDK can't load its configuration, such as on a first launch without a connection. - Fixes
refreshCustomerInfo()returning empty customer info when the fetch fails, instead of the device's purchases. - Fixes the Mac preview window sometimes selecting a different paywall than the one linked, without saying why.
- Stops sending user and device attributes for enrichment, such as the demand score, while
eventTrackingBehavioris.none. - Fixes a paywall showing and charging the wrong billing plan when the same App Store product is sold on both the up-front and monthly plans, on one paywall or across paywalls. Each paywall slot now keeps its own plan. Product identifiers are unchanged.
- Fixes paywalls letting the app rotate into orientations it doesn't allow. A paywall now allows the same orientations as the screen it covers, which matters for apps that lock orientation in a view controller rather than in their Info.plist, such as Unity games. Previously, a landscape-only game could be rotated to portrait while a paywall was showing and stayed in portrait after it closed.
4.19.0
Enhancements
- Adds native macOS 12+ support, including paywalls, SwiftUI embedding, purchases, Customer Center and Test Mode. See the Mac example to get started.
- Adds
Superwall.shared.refreshCustomerInfo(), which fetches the user's latest entitlements from Superwall and returns the updatedCustomerInfo. - Adds
StoreProduct.customTransactionId. Send it back from your server with a custom product's purchase events to attribute that revenue to the paywall that sold it. - Paywalls can sell custom store products through the checkout set up on the dashboard, without a
PurchaseController. - Entitlements your server has already reported for a custom product purchase now show up in the app straight after the purchase. If it reports them later, call
refreshCustomerInfo()once it has. - Apps without web paywalls now also refresh entitlements when they come to the foreground.
- Improves MMP install matching.
Fixes
- Fixes newer entitlements sometimes being overwritten, or saved to the wrong user after logging out.
- Fixes custom product purchases being reported as App Store purchases.
4.18.3
Fixes
- Moves the SDK's database out of the root of Application Support and into its own folder. Existing data is moved over on first launch.
- Fixes entitlements becoming inactive while an App Store subscription is in a billing grace period, when using StoreKit 2. During the grace period, the expiry date is when the grace period ends.
4.18.2
4.18.1
Enhancements
- Adds the
device.simulatorModelpaywall variable: the model a simulator emulates, such asiPhone19,4.device.deviceModelreports the host's architecture (arm64) in a simulator, so this lets paywalls that depend on the device model, such as the iPhone Duo safe area setting, be checked there. It is never sent from a real device.
4.18.0
Enhancements
- Raises the minimum iOS deployment target from iOS 13 to iOS 15, and the Swift Package Manager minimums for macOS and watchOS to macOS 12 and watchOS 8. Requires Xcode 26 (Swift 6.2) or later to build the SDK.
- Adds the Customer Center, a self-service screen where users can view, restore, manage, cancel, refund and change their purchases, and contact support. Present it with
Superwall.shared.presentCustomerCenter(),CustomerCenterVieworCustomerCenterViewController, and configure it withSuperwallOptions.customerCenter. - Adds
CustomerCenterDelegateand events for when the Customer Center opens, closes, and when users pick an action, answer a survey or request a refund. - Adds best-effort public IPv4 and IPv6 device attributes for apps using the Superwall MMP, and the IPv4 attribute for apps that set an AppsFlyer ID. Apps that use the MMP or set an AppsFlyer ID should declare IP address collection in their privacy manifest.
- Adds return links,
yourscheme://superwall/returnandhttps://<subdomain>.superwall.link/app-link/superwall/return. To open your app from a teleported web flow without the Open in App alert, addapplinks:<subdomain>.superwall.linkto your app's associated domains. They bring the user back to your app from a Superwall web flow, such as a paywall's checkout page, and leave the paywall open. Unlike other deep links, they don't trackdeepLink_openand don't dismiss the presented paywall. - Adds the
teleportOpenevent (teleport_open), tracked with the paywall's info when a paywall teleports the user to a web flow, such as its checkout page. - Adds the
teleportReturnevent (teleport_return), tracked instead ofdeepLink_openwhen a return link brings the user back to your app, with the presented paywall's info if there is one. - A web purchase from a paywall's checkout page now finishes like an App Store purchase: once the code is redeemed, the paywall runs the purchase button's after-purchase actions, and it's dismissed (as
.purchased) only when those actions close it. Redemption itself is unchanged, includingwillRedeemLink,didRedeemLinkand the redemption events. - Adds
SuperwallOptions.adConsentandSuperwall.shared.adConsentto report a user's ad consent (adUserDataandadPersonalization, each anAdConsentStatusof.grantedor.denied), which Superwall passes on with the conversions it uploads to Google Ads and Meta. IfadConsentis never set, the SDK uses the consent stored by an IAB TCF consent banner when GDPR applies, and otherwise defaults to granted; apps with users in the EEA, UK or Switzerland that don't use a TCF banner should set it from their consent flow. Where the values came from is reported in the newadConsentSourcedevice attribute (developer,tcfordefault). The values are reported as theadUserDataConsentandadPersonalizationConsentdevice attributes, and both as denied whileeventTrackingBehavioris.none. Personalization is also reported as denied when the user has denied App Tracking Transparency or it's restricted, unless you setadConsentyourself.
Fixes
- Fixes a preloaded paywall tracking only its first page view when its variables were refreshed after it opened.
- Fixes the SDK getting stuck in test mode when a sheet such as the Customer Center is already open as it finishes loading.
- Fixes subscribers staying in test mode on every launch after the dashboard setting that caused it had been corrected. The SDK no longer saves a config that turns test mode on, and no longer starts a launch from one saved by an earlier version.
- Stops matching installs for attribution unless the Superwall MMP is turned on for your app.
- Fixes paywalls on first launch missing acquisition attributes in their audience filters: they now wait up to 2 seconds for install attribution to finish.
- Fixes a paywall reporting
.declinedinstead of.purchasedwhen it closed after a purchase through an after-purchase action list, such as one that sets state and then closes. - Fixes the paywall's loading spinner staying up after a web checkout completed while an older pending checkout was still being polled.
- Fixes a web purchase on a paywall whose products carry different entitlements showing the restore failed alert.
- Fixes the test mode sheet not showing in apps with more than one scene or window.
- Fixes a paywall staying blank after iOS terminated its web content process.
4.17.0
Enhancements
- Adds
grantedEntitlementsso you can grant entitlements from your own backend, which the SDK merges with device and web entitlements. - Adds
userAttributesto theRedemptionInfoyou get fromdidRedeemLink, so you can read the answers someone gave on your web paywall funnel after they redeem in your app. - Adds
SuperwallOptions.devServerfor development builds: with asuperwall devserver running, paywalls render from your live, local paywall code while configuration, placements, audience evaluation and assignment stay real. Use.defaulton a simulator, which finds the dev server on localhost automatically; on a physical device use.url(...)with the Device URLsuperwall devprints. The dev server also activates test mode, disables preloading, and skips the test mode intro sheet.
Fixes
- Fixes trial reminders being scheduled for users who bought without getting the intro offer.
- Refreshes the IDFV, IDFA and tracking consent for integrations when the app becomes active or integration attributes are set again, and clears the IDFA when consent is revoked. These now also go into the user attributes
idfv,idfaandattStatus, so server-side integrations such as AppsFlyer can read them. The SDK owns those three keys and will overwrite any value your app has set on them.reset()and identifying a different user now keep the integration attributes that describe the device, such as the AppsFlyer and Adjust IDs, and drop the ones that describe the person, such as the Amplitude and Customer.io user IDs. - Fixes duplicate device attribute and subscription status change events being tracked when the subscription status is repeatedly set to the same logical state. As part of this,
subscriptionStatusDidChangenow fires only when the logical status changes — the status case, the set of entitlements, or an entitlement'sisActiveflag. Updates to transaction metadata such as expiry dates or renewal state no longer trigger it; usecustomerInfoDidChangefor those. - Fixes subscribers with an unexpired subscription being reported as
inactiveon cold launch when the App Store has no purchases to report. Refunded and expired App Store subscriptions still deactivate immediately. - Fixes slow cold launches for subscribers on a weak network by no longer fetching their purchased products from StoreKit before the SDK is ready. Applies to StoreKit 2.
- Fixes a data race during SDK configuration that Thread Sanitizer flagged on every launch.
- Fixes a crash when
registeris called from more than one thread at a time. - Fixes a hang when identifying a different user after an install attribution match had been found.
- Fixes issue where paying web users could end up having a temporary inactive subscription status if the server temporarily returns no entitlement data for them.
- Fixes audiences matching users they shouldn't when you use a Purchase Controller.
- Fixes paywall opens and purchases being reported under the wrong experiment when two campaigns share a paywall and a second placement fires while it is on screen.
4.16.3
4.16.2
Enhancements
- Adds the user's system-wide text size (Dynamic Type) as three device attributes for use in paywalls and audience filters:
fontScale,fontSize, andpreferredContentSizeCategory. - Links subscriptions to the user server-side after successful purchase or restore.
Fixes
- Fixes issue on localized paywalls where the default language would briefly show before re-rendering once device attributes arrive.
- Fixes a crash when an audience filter contains an expression that can't be evaluated, such as a computed property with an unquoted argument (
daysSince(app_install)). Updates Superscript to 1.0.15, which also stops any future evaluation failure from aborting the app. View the original Rust release changelog here. - Fixes network requests that can never succeed, such as those with an invalid API key, taking up to a minute to fail instead of failing straight away. Timeouts and server errors still retry as before.
- Fixes failed network requests being reported as a decoding error rather than the HTTP error that actually occurred.
- Fixes issue where the paywall debugger wouldn't work for accounts with many paywalls.
- Fixes Main Thread Checker warnings caused by reading the device's interface style and text size from a background thread.
- Prevents unused App Tracking Transparency support from triggering App Store Connect tracking warnings.
- Stops Apple's microphone, location, and contacts class and selector names appearing in your app's binary when you don't use those permissions.
- Fixes the app's accent color resetting to the system blue when configuring the SDK from a SwiftUI
Appinitializer.
4.16.1
Enhancements
- Clarifies that
IntegrationAttribute.onesignalIdshould be set to the OneSignal User ID used by the OneSignal integration.
Fixes
- Makes sure that the compiler directive is correct for billing plan types so that the SDK builds in Xcode version 26.4.