App submission

Use the app submission step to verify or change your selected release candidate build in app stores, review any final release settings, and submit your update for review.

Release workflow

If a release workflow or deploy branch is defined in your settings — for teams that produce different builds for staging/RC and production — you will see an additional module that displays the status of your production build workflow, along with a Run workflow action.

See our Builds and Branches article for additional information about configuring Runway for multiple build workflows.

Selected build in app store

The selected build module indicates which build is currently selected in the relevant app store, as well as its matching CI build identifier.

You can click the Change selected build action to switch the build that will be submitted for review. The list of builds will also show linked app store and CI build identifiers if available.

(iOS) Additional review submission items

Additional items (custom product pages or in-app events) can be included alongside your app version submission. To add an item to your review submission, use the Add item button visible on the App submission step. Additional items included in your review submission can be removed from the submission bundle anytime prior to version submission.

Handling review submission issues

If there's a problem with one or more of your review submission items, you can choose one of the following options:

  1. Remove the problematic review submission item and proceed with the release of approved items. You can do this from Runway.

  2. Manually resolve the problematic review submission item by going in to App Store Connect – this may involve making changes to the item, or answering questions posed by the App Store Review team. Note that manual item resolution is not currently supported within Runway.

  3. Pull your review submission bundle from review and resubmit.

(iOS) App Store Connect release settings

This module reflects current settings for this app version in App Store Connect.

  • Version release

    • Automatically release this version

    • Automatically release this version after App Review, no earlier than a specified time

    • Manually release this version

For more details on version release options, visit 🔗 Apple’s documentation.

  • Phased release

    • Off

    • On — When choosing this option, Apple will automatically increase your phased release percentage in the App Store each day over a 7-day period.

Phased release sequence: 1% of users on Day 1, 2% on Day 2, 5% on Day 3, 10% on Day 4, 20% on Day 5, 50% on Day 6, and 100% on Day 7.

For more details on Phased releases, visit 🔗 Apple’s documentation.

App review information

Here, you can verify key information that will be passed along to Apple’s reviewers here. To make changes, or to view all available fields, visit App Store Connect directly.

  • Contact — Information for the contact person in your organization if the App Review team needs additional information.

  • Sign-in required — Sign-in information for a demo account, if relevant.

  • Review notes — Additional information about your app that can help during the review process.

For more details on App review information, visit 🔗 Apple’s documentation.

(Android) Retained builds (Additional builds)

In certain cases for Android releases, you may want to include one or more past builds alongside new builds with your submission – this is known as retaining builds in the Play Console.

To choose past builds to include (retain) with your submission, click the dropdown on the right of "Change selected build", and click "Include build(s) from a previous release". Choose the past builds that you would like to retain and include alongside new builds with your submission.

Runway will automatically include the past builds you select when submitting your app for review.

Runway will automatically carry over any chosen retained builds to upcoming releases. You can stop retaining builds at any time by simply clearing the selection and saving.

(Android) Release settings

This module reflects the settings that Runway will use when submitting your app for review with Google.

  • Staged rollout

    • Don’t stage, release updates to all users immediately

    • Staged rollout to a percentage of users

    • Staged rollout with percent increasing over a 7-day period

      • When choosing this option, Runway will automatically increase your staged rollout percentage in the Play Console each day over a 7-day period. (1% of users on Day 1, 2% on Day 2, 5% on Day 3, 10% on Day 4, 20% on Day 5, 50% on Day 6, and 100% on Day 7).

App submission automations

You can configure the following App submission automations by visiting the Automations tab on this step:

App submission checklist

You can add checklist items to this step by visiting the Checklist tab.

Checklist items cover any unique parts of your team's release process and live across all your releases. Steps with checklist items won't be marked as complete (green) in Runway until all checklist items have been completed (in addition to the normal criteria that would mark a step as completed).

Last updated

Was this helpful?