# Types of notifications

## Categories

* [App reviews](#app-reviews)
* [Release announcement](#release-announcement)
* [Release cycle](#release-cycle)
* [Builds](#release-cycle-1)
* [Build bundle sizes](#release-cycle-2)
* [Release process tasks](#release-cycle-2)
* [Testing](#release-cycle-3)
* [Checklist items](#checklist-items)
* [Approval items](#release-cycle-4)
* [Regression testing items](#regression-testing-items)

{% hint style="info" %}
Notifications with a ':thread:' can be configured to use threads in Slack.
{% endhint %}

## App reviews

| Notification                 | Info                                                                                                                       |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Daily app reviews digest** | A recap of new reviews of your app within the past day.                                                                    |
| **New user review**          | A new review of your app was published.                                                                                    |
| **Review issues digest**     | A weekly recap of [issues](https://docs.runway.team/using-runway/rollout#review-issues) identified in reviews of your app. |

## Release announcement

| Notification             | Info                                                                                                                                                                                                                                                                                                                 |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Release announcement** | A detailed message about your newly-completed release. This notification includes [Release description](https://docs.runway.team/using-runway/release-steps/kickoff#release-description) content, which can be customized using [Patterned tokens](https://docs.runway.team/getting-started/pattern-strings-tokens). |

<figure><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2Fag6y3oUpOvWAEGDgenDE%2FScreenshot%202025-10-06%20at%205.03.46%E2%80%AFPM.png?alt=media&#x26;token=9722b0d4-f74d-45f8-8d96-8790934a4fe0" alt="Example of a release announcement Slack notification"><figcaption><p>Example of a release announcement Slack notification</p></figcaption></figure>

## Release cycle

<table><thead><tr><th width="42.69769287109375"> </th><th>Notification</th><th>Info</th></tr></thead><tbody><tr><td></td><td><strong>Kickoff reminder before target time/date</strong></td><td>Your target release kickoff time/date is approaching.</td></tr><tr><td></td><td><strong>Kickoff successful</strong></td><td><p>Your release was kicked off:</p><ul><li><p><em>Release branch teams</em></p><ul><li>A release branch was detected</li><li>Runway created a release branch</li></ul></li><li><p><em>Static branch teams</em></p><ul><li>Code promotion was detected</li><li>Runway promoted code from working branch to release branch</li></ul></li><li><p><em>Bump version status, if configured</em></p><ul><li>Runway attempted to bump version on working branch, link to PR</li><li>Runway bumped version on working branch</li></ul></li></ul></td></tr><tr><td></td><td><strong>Kickoff failed</strong></td><td><p>Your release could not be kicked off:</p><ul><li><p><em>Release branch teams</em></p><ul><li>Runway couldn’t create a release branch; needs to be created manually</li></ul></li><li><p><em>Static branch teams</em></p><ul><li>Runway couldn’t perform code promotion; needs to be done manually</li></ul></li></ul></td></tr><tr><td></td><td><strong>Release updated</strong></td><td><p>One of more of the following items were changed in the release:              </p><ul><li>Release pilot</li><li>Release name</li><li>Target kickoff date</li><li>Target submit date</li><li>Target release date </li></ul></td></tr><tr><td></td><td><strong>Pilot reminder for upcoming release</strong></td><td>A reminder for the pilot of the next release. The notification is triggered when an existing pilot is changed, or once the app version is released to the store. For Android, this happens immediately after the version is submitted, as releases typically begin rolling out right away. For iOS, the notification is sent at the actual release time, after Apple’s review process is complete.</td></tr><tr><td></td><td><strong>Schedule cadence paused or resumed</strong></td><td>Your schedule of recurring target times/dates in Runway was paused or resumed.</td></tr><tr><td></td><td><strong>VCS release successful</strong></td><td>Your update was successfully pushed to your VCS distribution platform (for teams that ultimately release to a platform like GitHub, etc).</td></tr><tr><td></td><td><strong>Manual submit to app store successful</strong></td><td>Your app update was manually submitted to the app store for review.</td></tr><tr><td></td><td><strong>Submit reminder before target time/date</strong></td><td>Your target app submission time/date is approaching. This notification will also call out any remaining incomplete steps.</td></tr><tr><td></td><td><strong>Automatic submit failed - incomplete steps</strong></td><td>Runway couldn’t automatically submit your release for review at the target time/date because one or more required steps were not complete (green).</td></tr><tr><td></td><td><strong>Automatic submit failed</strong></td><td>Runway was unable to automatically submit your release for review at the target time/date.</td></tr><tr><td></td><td><strong>App store status was updated</strong></td><td><p>Your status in the app store was changed to:</p><ul><li><p><em>iOS</em></p><ul><li>Waiting for Review</li><li>In Review</li><li>Approved</li><li>Rejected</li><li>Metadata rejected</li><li>Developer rejected</li><li>Released</li></ul></li><li><p><em>Android</em></p><ul><li>In Progress, Completed (only gets sent if <a href="#release-announcement">release announcement notification</a> is off)</li></ul></li></ul></td></tr><tr><td></td><td><strong>Release reminder before target time/date</strong></td><td>Your target app release time/date is approaching. This notification will also call out any remaining incomplete steps.</td></tr><tr><td></td><td><strong>Manual app store release successful</strong></td><td>Your app update was manually released to the app store.</td></tr><tr><td></td><td><strong>Automatic release by Runway was successful</strong></td><td>Runway automatically released (or started a phased release of) your app update at the target time/date.</td></tr><tr><td></td><td><strong>Automatic release by Runway failed - incomplete steps</strong></td><td>Runway couldn’t automatically release your app update at the target time/date because one or more required steps were not complete (green).</td></tr><tr><td></td><td><strong>Automatic release by Runway failed</strong></td><td>Runway was unable to automatically release your app update at the target time/date.</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f9f5">🧵</span></td><td><strong>Phased release / Staged rollout progress update</strong></td><td>An update on the progress of your phased release (iOS) / staged rollout (Android).</td></tr><tr><td></td><td><strong>Unstable phased release halted</strong></td><td>Runway automatically paused your phased release due to a low session stability rate.</td></tr><tr><td></td><td><strong>Stable phased release accelerated to 100%</strong></td><td>Runway automatically accelerated your phased release / staged rollout to 100% of users due to a high session stability rate.</td></tr><tr><td></td><td><strong>Health metrics rollout update/alert</strong></td><td><p>Runway will notify you when your health metrics become unhealthy or (optionally) are about to become unhealthy. </p><p>You can configure:</p><ol><li>when these alerts begin (based on adoption percentage or rollout day), and</li><li>which metrics are included, under <strong>Settings > Health metrics</strong>.</li></ol></td></tr><tr><td></td><td><strong>Provisioning profiles and/or certificates expiration approaching (Apple platforms only)</strong></td><td><p>One or more provisioning profiles and/or signing certificates active in your Apple Developer account is expiring soon. </p><p></p><p><em>You can configure this notification's reminder threshold for anywhere between 1 and 365 days until profile/certificate expiration.</em> </p><p></p><p><em>Reminders will send daily if at least one profile or certificate is expiring within the configured threshold, or has already expired in the last two weeks.</em></p></td></tr><tr><td></td><td><strong>Missing or expired agreements in App Store Connect</strong></td><td>Runway will send a reminder if there are required agreements that are missing or expired in App Store Connect.</td></tr></tbody></table>

## Builds

| Notification                                | Info                                                                                                                                                                                                                                                 |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **New build in progress**                   | ​CI started a workflow for a new Release Candidate build.                                                                                                                                                                                            |
| **Build stopped**                           | ​CI workflow for a new Release Candidate build was stopped.                                                                                                                                                                                          |
| **Build failed**                            | CI workflow for a new Release Candidate build failed.                                                                                                                                                                                                |
| **New build available**                     | CI successfully completed a new Release Candidate build.                                                                                                                                                                                             |
| **New build available w/ artifacts**        | CI successfully completed a new Release Candidate build, and build artifacts are available to download. ([More info](https://docs.runway.team/automations/types-of-automations#provide-build-artifact-downloads-and-notify-in-slack-when-available)) |
| **New production workflow build available** | CI successfully completed a new production build (for teams with a separate production build workflow).                                                                                                                                              |

## Build bundle sizes

| Notification          | Info                                                                                                                                                                                                                                                                                                                                |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Bundle size alert** | <p>​Build download size or <a data-footnote-ref href="#user-content-fn-1">install size</a> increases relative to current live release build (measured as a MB or percentage increase)</p><p></p><p>OR</p><p></p><p>Build download size is approaching or exceeds Apple cellular download limit of 200 MB (Apple platforms only)</p> |

{% hint style="info" %}
Build bundle size notifications send for app store builds in your next/active release, and only for those builds which have a [CI build match](https://docs.runway.team/using-runway/build-matching). You may choose to receive notifications for all builds that meet the configured conditions, or only the first build in a release that does so.
{% endhint %}

{% hint style="info" %}
Apple platforms fetch this data from the App Store Connect API, and you can specify what device model you want to monitor by configuring the 'Bundle size device model' setting in General app settings. Default is the 'Universal' device model.\
\
Google does not expose bundle size information via their APIs, so Runway calculates this locally using build artifacts. Therefore, you must have the [enable artifact downloads](https://docs.runway.team/automations/types-of-automations#enable-artifact-downloads) automation enabled, and only download size is available. Note that install size is not available and, for AABs, download size is averaged across device configurations (not universal).
{% endhint %}

## Release process tasks

<table><thead><tr><th width="43.189239501953125"> </th><th>Notification</th><th>Info</th></tr></thead><tbody><tr><td></td><td><strong>A step was approved</strong></td><td>​One of your release steps was marked as approved (for steps that need to be manually approved, currently applies to Screenshots and Metadata).</td></tr><tr><td></td><td><strong>New work has been added to this release</strong></td><td>A ticket or code was detected that prevented the Feature Readiness step from being considered done (green).</td></tr><tr><td></td><td><strong>Feature affiliations applied</strong></td><td>Runway automatically applied missing labels and/or Fix versions to tickets associated with your release in your project management tool. (<a href="../../automations/types-of-automations#add-missing-labels-or-fix-versions-to-tickets">More info</a>)</td></tr><tr><td></td><td><strong>Feature Readiness step is complete</strong></td><td>All work slated for this release (determined by tickets or code affiliated with the current version) is done.</td></tr><tr><td></td><td><strong>Ping pending work owners</strong></td><td>Notify work owners when one or more work items on the Feature Readiness step are still pending.</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f9f5">🧵</span> </td><td><strong>Fix created</strong></td><td>A user included an additional PR as a fix for an issue discovered during testing.</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f9f5">🧵</span> </td><td><strong>Fix request created</strong></td><td>A user requested a fix to be evaluated for inclusion in the release.</td></tr><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f9f5">🧵</span> </td><td><strong>Fix request updated</strong></td><td>A user updated (approved / denied) a fix request.</td></tr><tr><td></td><td><strong>Metadata is editable</strong></td><td>Metadata can now be edited for this release.</td></tr><tr><td></td><td><strong>Metadata defaults were applied</strong></td><td>Runway automatically applied your default metadata to this release. (<a href="../../automations/types-of-automations#apply-default-whats-new-text-to-new-releases-in-app-store-connect">More info</a>)</td></tr><tr><td></td><td><strong>Release tagged</strong></td><td>Your completed release was tagged by Runway. (<a href="../../automations/types-of-automations#tag-releases-at-the-end-of-the-release-cycle">More info</a>)</td></tr><tr><td></td><td><strong>Couldn't tag release</strong></td><td>Runway tried and failed to automatically tag your completed release.</td></tr><tr><td></td><td><strong>Selected build in app store was changed</strong></td><td>The selected build for release in the app store was manually changed via Runway.</td></tr></tbody></table>

## Checklist items

| Notification                            | Info                                                                                                                                                                                             |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Checklist item incomplete**           | One or more checklist items is incomplete and is preventing a step from being considered done (green).                                                                                           |
| **Checklist item completed**            | One of your checklist items was marked as done.                                                                                                                                                  |
| **Checklist item reminder**             | When one or more checklist items in a step are still pending, but the step is otherwise complete, Runway will send reminder notifications every 12 hours until the step's checklist is complete. |
| **Checklist items marked as completed** | Multiple checklist items were marked as done in bulk.                                                                                                                                            |
| **Step group checklist items reminder** | A user  reminders for one or more pending checklist items.                                                                                                                                       |

## Testing

<table><thead><tr><th width="47.04876708984375"></th><th>Notification</th><th>Info</th></tr></thead><tbody><tr><td><span data-gb-custom-inline data-tag="emoji" data-code="1f9f5">🧵</span></td><td><strong>Regression testing status updated</strong></td><td><p>​The status of your regression testing was changed to:</p><ul><li>Started</li><li>Not started</li><li>Passed</li><li>Failed</li></ul></td></tr><tr><td></td><td><strong>Beta testing build available for internal testing</strong></td><td>A new build is now available for internal testers on TestFlight (iOS), or has been promoted to a Google Play testing track (Android). </td></tr><tr><td></td><td><strong>New beta build available</strong></td><td>A new build has been detected by Runway (Android). </td></tr><tr><td></td><td><strong>Beta testing build submitted for review for external testing</strong></td><td>A beta testing build in TestFlight (iOS) was submitted for review in order to be available to external testers.</td></tr><tr><td></td><td><strong>Beta testing build available for external testing</strong></td><td>A build is now available for external testing on TestFlight (iOS).</td></tr><tr><td></td><td><strong>Beta soak started</strong></td><td>A new beta soak period started due to a new Release Candidate build becoming available.</td></tr><tr><td></td><td><strong>Beta soak complete</strong></td><td>Beta soak period has fully elapsed.</td></tr><tr><td></td><td><strong>Beta soak ended manually</strong></td><td>Beta soak period was marked as complete.</td></tr></tbody></table>

## Approval items

| Notification               | Info                                         |
| -------------------------- | -------------------------------------------- |
| **Approval item reminder** | One or more approval items are not complete. |

{% hint style="info" %}
Runway will send reminder notifications for incomplete approval items every 24 hours until all Approvals items are complete.

* Reminders will start automatically [depending on a few factors](#user-content-fn-2)[^2].
  {% endhint %}

{% hint style="info" %}
Owners of approval items will be mentioned in reminder notifications.
{% endhint %}

## Regression testing items

| Notification                         | Info                                                   |
| ------------------------------------ | ------------------------------------------------------ |
| **Regression testing item reminder** | One or more regression testing items are not complete. |

{% hint style="info" %}
Runway will send reminder notifications every 24 hours for incomplete regression testing items until all Regression testing items are complete.

* Reminders will start as soon as the Regression testing step [becomes active](#user-content-fn-3)[^3], and continue until all regression testing items are complete.
  {% endhint %}

[^1]: Apple platforms only

[^2]: * if a target submission date is set, reminders will start 72 hours before target submission

    - if a target release date is set, reminders will start 72 hours before target release

    * if neither target release nor target submission is set, reminders will start 72 hours after the release has been kicked off

[^3]: The Regression testing step becomes active as soon as a Release Candidate build for the release has succeeded.