Runway Documentation
  • About Runway
  • 🚀Getting started
    • Adding apps
    • Setting up your integrations
      • Branching strategies
      • Builds and branches
      • Pattern strings / tokens
    • Preparing your first release
    • Setting up your team
  • 🎛️Using Runway
    • Navigating Runway
    • Build Distro
      • Quickstart
      • Uploading builds for distribution
      • Build Distro buckets
      • Sharing builds
      • Installing builds
      • Signing and provisioning cheat sheet
    • App overview
    • Releases
      • Release overview
      • Feature flags
      • Kickoff
      • Feature readiness
      • Translations
      • Release candidate
      • Regression testing
      • Beta testing
      • Screenshots
      • Metadata
      • Approvals
      • App submission
      • App store review
      • Release
    • Release schedule
    • Rollout
    • Hotfixes
    • Rollbacks
    • Checklists
    • Build matching
    • App settings
      • General settings
      • Team settings
      • Release pilot rotation
      • Integrations settings
      • Profiles and devices
      • Signing keys
      • Health metrics settings
      • Automations settings
      • Notifications settings
      • Schedule settings
      • Beta testing settings
      • Metadata settings
      • Release defaults
      • Checklists settings
      • Custom strings settings
    • Organization overview
    • Organization settings
      • Team
      • SSO/SAML
    • User settings
    • Over-the-air (OTA) releases
  • ⚙️Integrations
    • Integrations overview
    • Version control
      • Azure Repos
      • Bitbucket
      • GitHub
      • GitLab
    • Project management
      • Asana
      • Azure Boards
      • GitHub Issues
      • Jira
      • Linear
      • Pivotal Tracker
      • Monday.com
      • Shortcut
    • CI/CD
      • App Center Build
      • Azure Pipelines
      • Bitbucket Pipelines
      • Bitrise
      • Buildkite
      • CircleCI
      • Codemagic
      • GitHub Actions
      • GitLab CI
      • Jenkins
      • TravisCI
      • Xcode Cloud
    • Regression testing
      • TestRail
      • Xray
    • Beta testing
      • Google Play testing tracks
      • TestFlight
      • App Center
      • Firebase App Distribution
    • App stores
      • App Store Connect
      • Google Play Console
      • Amazon Appstore
      • Huawei AppGallery
      • Samsung Galaxy Store
    • Notifications
      • Microsoft Teams
      • Slack
    • Stability monitoring
      • BugSnag
      • Datadog
      • Embrace
      • Firebase Crashlytics
      • New Relic
      • Sentry
      • Dynatrace
    • Observability & analytics
      • Amplitude
      • Datadog
      • Google Analytics
      • Mixpanel
      • New Relic
      • Custom observability & analytics
    • Feature flagging
      • Optimizely
      • LaunchDarkly
    • Scheduling
      • Opsgenie
      • PagerDuty
    • Translations
      • Crowdin
      • Lokalise
    • Calendar
      • Google Calendar
  • ⚡Automations
    • Automations overview
    • Types of automations
  • 🔔Notifications
    • Notifications overview
    • Types of notifications
  • 🪝Webhooks
    • Outgoing webhooks
  • 📡REST API
    • Overview
    • Reference Docs
    • Markdown Badge API
    • App configuration files
  • 🛠️Quickstart CI/CD
    • Quickstart CI/CD overview
    • Getting started
  • Support
    • Contact us
Powered by GitBook
On this page
  • Release notes / What’s New in this Version
  • Additional metadata fields
  • Approval
  • Metadata translations
  • Metadata automations
  • Metadata checklist

Was this helpful?

  1. Using Runway
  2. Releases

Metadata

PreviousScreenshotsNextApprovals

Last updated 4 days ago

Was this helpful?

From the Metadata step, you can edit and review version release notes (also referred to as ‘What’s New in this Version’ for iOS) and other release metadata that will be reflected in the app stores upon release of the current version. Certain app-level metadata fields (e.g. App name, App subtitle) can also be edited from this step.

Release notes / What’s New in this Version

Enter the release notes for your upcoming version here.

  • A green status dot will appear on tabs where notes have been filled in for that localization.

  • An orange status dot will appear on tabs where required notes are still missing.

Each available localization will be displayed in a dedicated tab.

You can choose to Save [Region] changes on each tab individually, or Save all changes via the button at the bottom of the view. Save actions will send your changes to App Store Connect or the Play Console.

Autogenerate release notes

Using AI, Runway automatically drafts release notes by analyzing project management tickets and code changes (PRs and commits only, not the source code itself). When used for app store submissions, Runway tailors the notes to meet platform-specific requirements, such as character limits and disallowed characters.

For more structured outputs, Runway can generate changelogs that focus either on the release’s code diff or the associated project tickets. You can also define template-based release notes with dynamic tokens (e.g., {workItems} ,{contributorsCount}, {releasePilot}), which Runway fills in automatically based on the release context.

All of the above options are available in Runway wherever you can enter different kinds of release notes: store metadata, release description, release summary, and beta testing notes.

Feature list

Click the Feature list button on any tab to open a drawer listing new work that is appearing in the current release. This is a list of ticket titles that are associated with the current version.

The feature list can be handy in situations where an outside team member (often from Design or Marketing) is tasked with writing user-friendly release notes, but may not be familiar with the work going into the release.

Additional metadata fields

See below the complete list of metadata fields that can be currently edited from Runway for each platform.

iOS

  • Keywords

  • Promotional text

  • App name

  • App subtitle

  • App description

Android

  • Short description

  • App name

  • Video URL

Some metadata fields don't need to be submitted as part of a version update and will be submitted for review as soon as they're saved/updated in Runway.

Approval

Granting approval for metadata is a way for your team to communicate in Runway that metadata have been verified on each release.

App stores are not affected by the approval status of the Metadata step in Runway. Missing approvals on the Metadata step will not block a manual submission or release performed from Runway, or those performed directly from the app stores.

Approval can be reversed by users with sufficient privileges by clicking the Rescind metadata approval button. This will return the step status to orange and may block automations that depend on this step being green/ready.

Metadata translations

If you have a Translations integration connected to your app, you can use Runway's Metadata step to upload release metadata for translation, and export translated metadata from your translations provider to the relevant app store. The translation status of each metadata field for each locale will be shown as follows:

  • Synced – the field's value has been translated and synced to App Store Connect or Play Console.

  • Export needed – the field's value has been translated but an export is required to sync the latest translation to App Store Connect or Play Console.

  • Waiting for translation – the field's updated source value has been uploaded and is pending translation in your translations provider.

  • Upload needed – the field's source value has been updated in Runway but haven't yet been uploaded to the translations provider.

Uploading metadata for translation

To upload new release metadata for translation, save changes to the desired metadata fields in your app's source locale. You can then manually trigger an upload using the Upload for translation button – updated source value release metadata will be uploaded for translation to your your translations provider.

Exporting translations to App Store Connect or Play Console

To export translated metadata to App Store Connect or Play Console, you can manually trigger an export using the Export translated metadata button from the Metadata step. Any locales that have complete metadata translations in your translations provider will be exported to App Store Connect or Play Console and synced to Runway.

Metadata automations

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

Editing automation settings from an individual release will apply those changes to all of your upcoming releases for that app.

Metadata checklist

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

If you have defined , you can click the Apply default release notes button to pull in your default notes.

If you turn on the automation, Runway will automatically apply your default notes to each release.

Release pilots or other users with sufficient privileges can click the Approve metadata button at the bottom of the view to mark this step as ready. This will set the Metadata step as green/ready (and may unblock automations like that depend on all previous steps being green).

Enable the to have Runway automatically upload updated source locale metadata for translation, and export translated metadata to App Store Connect or Play Console as needed.

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).

🎛️
Checklist items
default release notes in App Settings
Apply default release notes
Submit app for review on target date
Sync metadata translations automation
Apply default 'What's New' or release notes text to new releases in App Store Connect or Play Console
Sync metadata translations