From 1615cd2c898b971fa41acb4e593b08246e1f595b Mon Sep 17 00:00:00 2001 From: Jordan Morgan Date: Thu, 29 Jan 2026 13:10:57 -0600 Subject: [PATCH] Remove paywall timeout references from docs Removed documentation and analytics references to paywall timeout behavior and the `timeoutAfter` property in PaywallOptions. Updated related guides to reflect current SDK behavior and removed the `paywallWebviewLoad_timeout` event from analytics documentation. --- .../docs/android/sdk-reference/PaywallOptions.mdx | 8 -------- .../3rd-party-analytics/tracking-analytics.mdx | 1 - ...ling-paywalls-during-poor-network-conditions.mdx | 4 ++-- src/lib/changelog-entries.json | 13 ++++++++++++- 4 files changed, 14 insertions(+), 12 deletions(-) diff --git a/content/docs/android/sdk-reference/PaywallOptions.mdx b/content/docs/android/sdk-reference/PaywallOptions.mdx index fa8b7ea..5c072ee 100644 --- a/content/docs/android/sdk-reference/PaywallOptions.mdx +++ b/content/docs/android/sdk-reference/PaywallOptions.mdx @@ -12,8 +12,6 @@ Customize how paywalls look and behave, including preload behavior, alerts, dism ## Signature ```kotlin -import kotlin.time.Duration - class PaywallOptions { var isHapticFeedbackEnabled: Boolean = true @@ -34,7 +32,6 @@ class PaywallOptions { var overrideProductsByName: Map = emptyMap() var optimisticLoading: Boolean = false - var timeoutAfter: Duration? = null var onBackPressed: ((PaywallInfo?) -> Boolean)? = null } ``` @@ -102,10 +99,6 @@ class PaywallOptions { description: "Hides shimmer optimistically.", default: "false", }, - timeoutAfter: { - type: "Duration?", - description: "Duration until a paywall timeout is invoked. When not using fallback loading, setting this triggers a timeout instead of retrying.", - }, onBackPressed: { type: "((PaywallInfo?) -> Boolean)?", description: "Callback invoked when back button is pressed (requires `reroute_back_button` enabled in paywall settings). Return `true` to consume the back press, `false` to use SDK default behavior.", @@ -129,7 +122,6 @@ val paywallOptions = PaywallOptions().apply { "tertiary" to "com.example.premium_annual", ) optimisticLoading = false - timeoutAfter = null onBackPressed = { paywallInfo -> // Custom back button handling // Return true to consume the back press, false to use SDK default diff --git a/content/shared/3rd-party-analytics/tracking-analytics.mdx b/content/shared/3rd-party-analytics/tracking-analytics.mdx index 7262878..f9ab302 100644 --- a/content/shared/3rd-party-analytics/tracking-analytics.mdx +++ b/content/shared/3rd-party-analytics/tracking-analytics.mdx @@ -57,7 +57,6 @@ The full list of events is as follows: | `paywallWebviewLoad_fail` | When a paywall's webpage fails to load. | Same as `paywall_close` | | `paywallWebviewLoad_fallback` | When a paywall's webpage fails and loads a fallback version. | Same as `paywall_close` | | `paywallWebviewLoad_start` | When a paywall's webpage begins to load. | Same as `paywall_close` | -| `paywallWebviewLoad_timeout` | When the loading of a paywall's webpage times out. | Same as `paywall_close` | | `paywallWebviewLoad_processTerminated` | When the paywall's web view content process terminates. | Same as `paywall_close` | | `reset` | When `Superwall.reset()` is called. | None | | `restoreComplete` | When a restore completes successfully. | None | diff --git a/content/shared/showing-paywalls/handling-paywalls-during-poor-network-conditions.mdx b/content/shared/showing-paywalls/handling-paywalls-during-poor-network-conditions.mdx index 730f322..ddf25e0 100644 --- a/content/shared/showing-paywalls/handling-paywalls-during-poor-network-conditions.mdx +++ b/content/shared/showing-paywalls/handling-paywalls-during-poor-network-conditions.mdx @@ -6,7 +6,7 @@ sidebarTitle: "Handling Poor Network Conditions" Superwall's SDK handles network issues as gracefully as possible, but there are still some scenarios to consider. The behavior will be different based on if `subscriptionStatus` evaluates to `.active(_)` or not. -**If it is `.active(_)`** and Superwall has already fetched or cached its configuration, then paywall presentation proceeds as it normally would. If Superwall was unable to fetch its configuration, the SDK waits one second to give it a chance to be retrieved. After that time, if it's not available — then a timeout event is tracked and the `onError` handler will be invoked with the error code 105. The "feature" block or closure will not be invoked: +**If it is `.active(_)`** and Superwall has already fetched or cached its configuration, then paywall presentation proceeds as it normally would. If Superwall was unable to fetch its configuration, the SDK waits one second to give it a chance to be retrieved. After that time, if it's not available, the `onError` handler will be invoked with the error code 105. The "feature" block or closure will not be invoked: ```swift Superwall.shared.register(placement: "foo") { @@ -16,4 +16,4 @@ Superwall.shared.register(placement: "foo") { **If it's not `.active(_)`** then Superwall will retry network calls until we have retrieved the necessary data for up to one minute. If it's still unavailable, then the SDK fires the `onError` handler with the error code of `104`. -For more information, please visit this [blog post](https://superwall.com/blog/handling-connectivity-interruptions-with-superwall). \ No newline at end of file +For more information, please visit this [blog post](https://superwall.com/blog/handling-connectivity-interruptions-with-superwall). diff --git a/src/lib/changelog-entries.json b/src/lib/changelog-entries.json index 2fec9a1..2ee7ea9 100644 --- a/src/lib/changelog-entries.json +++ b/src/lib/changelog-entries.json @@ -1,6 +1,17 @@ { - "lastUpdated": "2026-01-22T21:40:55.625Z", + "lastUpdated": "2026-01-29T18:48:02.653Z", "entries": [ + { + "key": "content/docs/ios/guides/intro-offer-eligibility-override.mdx:e0afc022a8d31aab921abfe1643ee331eeb175a1", + "path": "ios/guides/intro-offer-eligibility-override.mdx", + "title": "Overriding Introductory Offer Eligibility", + "description": "Updated guides for iOS SDK", + "category": "iOS SDK", + "subcategory": "Guides", + "url": "/docs/ios/guides/intro-offer-eligibility-override", + "date": "2026-01-23T11:36:25.000Z", + "changeType": "modified" + }, { "key": "content/docs/dashboard/overview-metrics.mdx:4d42c4b03754f3ae641edfceeffdb38ef56a27d9", "path": "dashboard/overview-metrics.mdx",