App Store Review & Compliance

This page outlines recommended best practices when using the onboarding system in apps distributed via the Apple App Store.

The onboarding system enables remote configuration of pre-bundled onboarding screens.
App Store compliance depends on how the system is used within a specific app.

Introducing New Screen Types

We recommend introducing new onboarding screen types only through a new app bundle version submitted to the App Store for review.

While existing screen types can be reconfigured remotely, new screen types — especially those involving new interactions or native UI components (e.g. date pickers, system dialogs, permissions) — should always be included and visible during App Store review.

Best practice

New screen type → new App Store submission
Existing screen type → remote configuration allowed

Remote Configuration

It is generally acceptable to update the following over the air for already reviewed screen types:

Screen order and flow logic within onboarding
Visibility and number of screens
Content, texts, and labels
Design and layout configuration

All executable logic and screen implementations must already be included in the submitted app binary.
Remote configuration should be limited to data and presentation, not new functionality.

Native UI Components and System Capabilities

Screens that use native UI components or system capabilities (such as date pickers, camera access, or permissions) should be handled with special care.

We recommend ensuring that:

such screens are introduced through App Store review
their behavior and purpose are clearly visible to reviewers
no new system capabilities are enabled remotely after approval

Responsibility and Compliance

App Store compliance is determined by the overall behavior and content of the app.

You are responsible for ensuring that:

onboarding flows comply with App Store Review Guidelines
onboarding texts and copy do not violate platform policies
no unreviewed functionality is introduced through remote configuration

Misuse of onboarding content (e.g. misleading texts, policy-violating flows, or inappropriate prompts) may still result in App Store rejection, regardless of the tooling used.

This system can be used in a compliant manner, but it does not guarantee App Store approval.

App Store Review Notes (Optional)

You may include the following text in the App Store Review Notes to help reviewers understand the onboarding setup:

This app uses a remote configuration system to control the order and content of pre-bundled onboarding screens.
All onboarding screens and logic are included in the submitted binary.
No executable code, native functionality, or system capabilities are downloaded or modified after submission.

Summary

Remote configuration is intended for presentation and flow control
New screen types should be introduced through App Store review
Compliance depends on correct and responsible usage