docs: Add Exit Offers playbook and cross-references across docs#1391
Open
RikH81 wants to merge 2 commits intoRevenueCat:mainfrom
Open
docs: Add Exit Offers playbook and cross-references across docs#1391RikH81 wants to merge 2 commits intoRevenueCat:mainfrom
RikH81 wants to merge 2 commits intoRevenueCat:mainfrom
Conversation
- Add new Exit Offers playbook (docs/playbooks/guides/exit-offers.mdx) with end-to-end guide covering configuration, presentation methods, platform support, best practices, and testing guidance - Add exit offers section to Offerings page explaining the need for a separate Offering - Add exit offers to Experiments introduction as a testable use case - Add cross-links from existing exit offer sections in creating-paywalls and displaying-paywalls to the new playbook - Register new playbook in sidebars.ts under Monetization Models
- Expand Apple App Store commission section with year 1+ rate reduction - Clarify that commission_percentage differs from published store rates - Document Stripe commission_percentage as NULL - Add EU alternative terms caveat - Clarify Google Play subscription vs non-subscription fee logic - Add cross-links in webhook and scheduled data export field descriptions - Add new Paddle and Roku commission estimation pages
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation / Description / Changes introduced
Exit offers are a powerful feature for recovering potentially lost conversions, but their documentation is currently limited to the Paywalls section. This PR improves discoverability and provides a comprehensive guide by:
New Exit Offers Playbook (
docs/playbooks/guides/exit-offers.mdx): A complete, end-to-end guide covering when to use exit offers, subscription configuration steps (Entitlements, Products, Offerings), paywall setup, supported presentation methods, platform support matrix, best practices, and testing guidance. Follows the established playbook pattern (e.g.,hard-paywall.mdx).Offerings page cross-reference (
docs/offerings/offerings.md): Adds an "Exit Offers" subsection under "Paywalls" explaining that exit offers require a separate Offering, with a link to the configuration docs.Experiments mention (
docs/tools/experiments-v1.md): Adds exit offers as a testable use case in the A/B testing list.Cross-links in Paywalls pages (
creating-paywalls.mdxanddisplaying-paywalls.mdx): Adds links from the existing exit offer sections to the new playbook for users who want the full implementation guide.Sidebar registration (
sidebars.ts): Registers the new playbook under Playbooks > Monetization Models.Links to discussion, or Linear ticket (if applicable)
Related release: https://www.revenuecat.com/release/show-exit-offers-when-a-paywall-is-dismissed-2025-12-31
Additional comments
No code blocks or new images were required since exit offers are a no-code, dashboard-only feature. The existing screenshot (
paywalls-exit-offer-configuration.png) is reused in the playbook.