5.6 - Bring Your Own Screen & Conditional Visibility

Purchasely SDK 5.6.0 focuses primarily on 2 highly asked features:

• Bring Your Own Screen with Flows
• Conditional Visibility

Version per platform

Changelog per platform is available on their GitHub repositories.
You can access them by clicking on the version number.

---

🧩 Bring Your Own Screen (BYOS)

ℹ️

Native SDK only

This feature is available only with Purchasely Android and iOS SDKs for now. It will be available in the coming months for Flutter, React Native and Cordova.

Purchasely now allows you to fully design and render your own paywall or subscription screens while still benefiting from the power of the Purchasely platform.

With Bring Your Own Screen (BYOS), you can:

• Use your own UI, your own components, and your own branding with complete freedom.
• Keep Purchasely’s purchase handling, eligibility checks, analytics, and event tracking fully intact.
• Seamlessly integrate your custom screen using a simple configuration and lightweight rendering contract.
• Access all pricing information, introductory offer eligibility, and localized content to display them exactly as you want.

This feature unlocks full creative control while maintaining a robust and reliable purchase flow powered by Purchasely.

More information in our documentation

🎛️ Advanced Conditional Blocks

You now have full control over when and how UI components appear inside your Purchasely-powered screens.

With Advanced Conditional Blocks, you can dynamically display or hide components based on:

• Introductory Offer eligibility (eligible / not eligible)
• Audience membership (e.g., churned users, new users, high-value customers…)
• Custom user attributes (country, language, subscription state, feature flags…)
• User interactions with other components such as:
  • pickers
  • tabs
  • switches
  • buttons
  • and more

This allows you to build truly personalized, context-aware, and reactive screens directly from the Purchasely Console still no-code.

🛠 New Debug Screen for Developers

A brand-new Debug Screen is now available to help developers understand exactly what Purchasely is doing behind the scenes, making troubleshooting faster and integrations smoother.

You can activate it in two ways:

• Scan the Preview Mode QR Code from the Purchasely Console or

• Enable it directly in your app with:

  SwiftKotlin

  Purchasely.setDebugMode(true)

  Purchasely.debugMode = true

Once enabled, you’ll see a powerful information overlay on top of any Purchasely screen, including:

• Screen ID
• Placement ID
• Audience
• A/B test assignment
• SDK version
• Anonymous user ID
• And more to come…

This initial release lays the groundwork — future versions will expand visibility, provide richer context, and make it easier to share diagnostics with Purchasely support.

---

🍎 iOS

• Fixed an issue with displayMode accessibility.
• Improved concurrency management if SDK is called from a background thread.
• Enhanced navigation bar display and styling for better consistency.

---

🤖 Android

🚧

Upcoming minSDK requirement

We will soon raise the minimum supported Android SDK version of Purchasely to minSdk 23 (Android 6.0), following updates in AndroidX libraries and Google Play Billing, which now also require minSdk 23.
Please ensure your application is already configured with minSdk 23, as this change will be mandatory to integrate future versions of the Purchasely SDK.

The current release still supports minSdk 21.

🐛 Bug Fixes

• Fixed an issue where displaying multiple Purchasely screens simultaneously could lead to incorrect event data or inconsistent user interactions.
• Corrected bottom content padding on devices running SDK ≥ 35 for proper UI layout.
• Resolved inaccurate promotional offer data when using the paywall action interceptor.

📦 Dependency Updates

• Android Gradle Plugin : 8.13.0 → 8.13.1
• Android Library Plugin : 8.13.0 → 8.13.1
• ZXing Core : 3.5.3 → 3.5.4