From f95ea6ba6b8c8a27c8a84b6dddc2afdc753638e8 Mon Sep 17 00:00:00 2001
From: Armin Dervisagic <drv.armin@gmail.com>
Date: Fri, 16 Jan 2026 19:25:55 +0800
Subject: [PATCH] Added doc for intro offer eligibility override

---
 .../intro-offer-eligibility-override.mdx      | 42 +++++++++++++++++++
 content/docs/ios/meta.json                    |  1 +
 2 files changed, 43 insertions(+)
 create mode 100644 content/docs/ios/guides/intro-offer-eligibility-override.mdx

diff --git a/content/docs/ios/guides/intro-offer-eligibility-override.mdx b/content/docs/ios/guides/intro-offer-eligibility-override.mdx
new file mode 100644
index 0000000..5e5c789
--- /dev/null
+++ b/content/docs/ios/guides/intro-offer-eligibility-override.mdx
@@ -0,0 +1,42 @@
+---
+title: "Overriding Introductory Offer Eligibility"
+description: "Control when users see free trials and intro offers on your paywalls by overriding the default eligibility logic."
+---
+
+## Overview
+
+Starting with iOS SDK 4.11.0, you can override the default introductory offer eligibility logic to control when users see free trials and intro offers on your paywalls. This allows you to show intro offers to returning users (as "promo offers") or to prevent them from appearing entirely.
+
+This feature is configured entirely through the Paywall Editor in the Superwall Dashboard. No code changes are required in your app.
+
+## Requirements
+
+- **iOS SDK:** Version 4.11.0 or later
+- **Platform:** iOS only (App Store products)
+
+## How It Works
+
+By default, Superwall uses Apple's StoreKit to determine if a user is eligible for an introductory offer. Apple's rules state that users can only claim an introductory offer once per subscription group.
+
+With this feature, you can override this behavior to:
+- **Show intro offers to returning users** who have already used a trial (useful for win-back campaigns)
+- **Hide intro offers entirely** even if users are eligible
+- **Use the default behavior** (let StoreKit decide)
+
+## Configuration
+
+1. Open your paywall in the Paywall Editor
+2. Go to the **Products** menu in the left sidebar
+3. Select an option from the **"Introductory Offer Eligibility"** dropdown
+4. Publish your paywall
+
+### Options
+
+**Automatic (Default)**
+Uses Apple's default eligibility rules
+
+**Always Eligible**
+Allows users to see and claim intro offers, even if they've used one before
+
+**Always Ineligible**
+Prevents users from seeing intro offers
\ No newline at end of file
diff --git a/content/docs/ios/meta.json b/content/docs/ios/meta.json
index 73b0a1b..4811b56 100644
--- a/content/docs/ios/meta.json
+++ b/content/docs/ios/meta.json
@@ -60,6 +60,7 @@
         "guides/embedded-paywalls-in-scrollviews",
         "guides/superwall-deep-links",
         "guides/app-privacy-nutrition-labels",
+        "guides/intro-offer-eligibility-override",
         "guides/advanced",
         "guides/migrations",
         "[Caffeine Pal Example App](https://github.com/superwall/CaffeinePal/tree/using-superwall-sdk)",