Convert paywalls to flows by titerman · Pull Request #418 · adaptyteam/adapty-docs

titerman · 2026-07-14T05:01:12Z

No description provided.

eandreeva-twr · 2026-07-20T13:30:38Z

+keywords: ['paywall builder', 'old paywall builder', 'move to new builder', 'paywall migration']
+---
+
+If your current paywall was made in the old Paywall Builder, you can convert it into a flow without rebuilding it. <Inline id="move-to-new-builder.svg" alt="Move to new builder" /> **Move to new builder** recreates the paywall as an editable flow in one click. Layout, text, products, and localizations carry over. Your original paywall stays live and unchanged, so you can build and test the flow before you switch to it.


Move to new builder

Не крит вообще, но вопрос ленивого человека: зачем добавлять иконку тогда, когда есть текст, которого хватает для идентификации кнопки/функциональности? Мб, будем иконки вставлять только тогда, когда нет текста?

eandreeva-twr · 2026-07-20T13:31:33Z

+
+If your current paywall was made in the old Paywall Builder, you can convert it into a flow without rebuilding it. <Inline id="move-to-new-builder.svg" alt="Move to new builder" /> **Move to new builder** recreates the paywall as an editable flow in one click. Layout, text, products, and localizations carry over. Your original paywall stays live and unchanged, so you can build and test the flow before you switch to it.
+
+## What carries over


А мы как будто уже это пишем в последнем предложении интро. Можно его отдельным абзацем вынести, и тогда эта секция уже не так нужна будет

eandreeva-twr · 2026-07-20T13:32:42Z

+
+The new flow is a separate copy. Your original paywall keeps running until you decide to switch.
+
+### Known limitations


Давай сделаем это последней секцией в статье. Это же то, что мелким шрифтом в конце договора пишут, и это больше для референса

eandreeva-twr · 2026-07-20T13:35:44Z

+- **Hero images and videos**: A full-width image or video may not carry over exactly as in the original paywall.
+- **Media overlays**: Flows don't support overlay images yet.
+- **Image tint and mask**: Neither carries over.
+- **Custom fonts**: Fonts don't carry over on their own. [Upload the fonts and manually style the text](using-custom-fonts-in-flow-builder) after the conversion.
+- **Layer order**: A known z-index bug can stack some elements in the wrong order.
+- **Relative sizing**: Flows can't size elements as a percentage of the parent.
+- **Maximum width**: Flow elements don't have a maximum width setting.
+- **Spacing and padding** may drift insignificantly.


Вообще такой большой список грустно звучит, не хочется всем его показывать... мб, что-то к релизу исправят?

Хочется и честными остаться, и людей не пугать — как будто можно попробовать более общими словами обрисовать

eandreeva-twr · 2026-07-20T13:36:57Z

+
+To convert a paywall into a flow, open the paywall's overview page and click <Inline id="move-to-new-builder.svg" alt="Move to new builder" /> **Move to new builder**.
+
+The <Inline id="move-to-new-builder.svg" alt="Move to new builder" /> **Move to new builder** button only appears for paywalls made with the old Paywall Builder. Paywalls built by hand need to be [recreated manually](paywall-builder-templates).


Paywalls built by hand need to be recreated manually.

Меня бы это смутило как пользователя, потому что мы этот сценарий вообще никак не упоминаем. Да и зачем им кастомные пэйволы мигрировать

eandreeva-twr · 2026-07-20T13:39:53Z

+## Why you should migrate

-With separate onboardings and paywalls, you maintain two builders and two placements. You also hand users off from the onboarding to the paywall in your own code.
+Adapty is sunsetting the standalone paywall and onboarding builders. Flows already offer native rendering, superior performance, and a richer feature set. New features will only ship to flows.

-A flow replaces both with one experience — intro screens, a quiz, and the purchase screen — built in one editor and served from one placement.
+Flows also replace two builders and two placements with a streamlined experience, so there's less to build and maintain. And moving is easy — you can convert your paywall builder creations in one click.

-The table below compares what each option gives you:
+Your existing onboardings and paywalls keep working, so nothing breaks before you migrate. Move at your own pace.


Это можно ворнингом в конце интро сделать вообще

И сократить в духе "С 1 октября пэйволы и онбординги превратятся в тыкву. Успей перейти на флоу — ты ничего не теряешь, и это довольно легко"

eandreeva-twr · 2026-07-20T13:41:07Z

+Migration takes three steps and minimal code changes. If you used the old paywall builder, the design can be converted with a single click.

-Your existing onboardings and paywalls keep working, and Adapty continues to support them. New features, however, now ship to flows rather than to the standalone onboarding and paywall builders.
+1. **[Convert or recreate your paywall](#convert-your-paywall-or-recreate-it-by-hand)**. If a paywall is made with the old Paywall Builder, you can convert it to a flow with a single click — no developer needed. Any other paywall or onboarding needs to be [manually recreated](paywall-builder-templates).


Any other paywall or onboarding needs to be manually recreated.

Звучит грустно! Мы в основном здесь про этот кейс и пишем, а другое лучше не упоминать пока. Пока что никто не спрашивал "как повторить мой кастомный пэйвол" или "как мигрировать мой онбординг"

eandreeva-twr · 2026-07-20T13:41:30Z

-2. **[Preview on device](#preview-on-device)**: Check the flow on a real device through the Adapty mobile app; no app build needed.
-3. **[Create a new placement for your flow](#create-a-new-placement-for-your-flow)**: Create a new flow placement with its own unique ID, and decide how it coexists with your existing placements.
-4. **[Update the SDK](#update-the-sdk)**: Upgrade to iOS, Android, React Native, or Capacitor SDK v4, fetch the flow from its placement, and verify a sandbox purchase. This is the main developer task.
+If you built the paywall by hand, or you're migrating an onboarding, one-click conversion isn't available. [Create a flow](paywall-builder-templates) from one of the available templates — or completely from scratch.


то же самое

eandreeva-twr · 2026-07-20T13:42:32Z

+Main article: [Convert a paywall into a flow](convert-paywall-to-flow)
+:::
+
+:::warning


то же самое — лучше убрать

eandreeva-twr · 2026-07-20T13:43:16Z


 Start from Scratch creates a flow with a single blank screen. Design the screen with elements from the [elements library](builder-elements).

+## Convert an existing paywall


тут можно сформулировать в духе Migrate a paywall from the legacy Paywall Builder, чтобы было яснее + так добавишь кивордов

ready for review

80cd6c1

titerman requested a review from eandreeva-twr as a code owner July 14, 2026 05:01

titerman added 6 commits July 14, 2026 02:14

minor framing fix

b9df1ec

quickfix

54d8ac4

more hotfixes

46e51fd

more awkward phrasing removed

686a06c

expand known issue list

eb7a9ac

quickfix

c2393b8

eandreeva-twr reviewed Jul 20, 2026

View reviewed changes

Navigation Menu

Uh oh!

Convert paywalls to flows - #418

Convert paywalls to flows#418
titerman wants to merge 7 commits into
mainfrom
ADP-6994

titerman commented Jul 14, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

eandreeva-twr Jul 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		If your current paywall was made in the old Paywall Builder, you can convert it into a flow without rebuilding it. <Inline id="move-to-new-builder.svg" alt="Move to new builder" /> Move to new builder recreates the paywall as an editable flow in one click. Layout, text, products, and localizations carry over. Your original paywall stays live and unchanged, so you can build and test the flow before you switch to it.

		## What carries over


		The new flow is a separate copy. Your original paywall keeps running until you decide to switch.

		### Known limitations


		To convert a paywall into a flow, open the paywall's overview page and click <Inline id="move-to-new-builder.svg" alt="Move to new builder" /> Move to new builder.

		The <Inline id="move-to-new-builder.svg" alt="Move to new builder" /> Move to new builder button only appears for paywalls made with the old Paywall Builder. Paywalls built by hand need to be [recreated manually](paywall-builder-templates).


		Start from Scratch creates a flow with a single blank screen. Design the screen with elements from the [elements library](builder-elements).

		## Convert an existing paywall

Uh oh!

Conversation

titerman commented Jul 14, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants