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
  • Available token types
  • Usage

Was this helpful?

  1. Getting started
  2. Setting up your integrations

Pattern strings / tokens

PreviousBuilds and branchesNextPreparing your first release

Last updated 2 years ago

Was this helpful?

When setting up patterned strings in Runway to define your team’s naming conventions around , , or , you can optionally use tokens to allow for dynamic naming conventions that depend on the release’s version, build numbers, etc.

Available token types

  • {version} β€” three-segment SemVer

    • Example: 1.2.3

  • {versionConcise} β€” allows for a three-, two- or one-segment SemVer

    • Example: 1.2.3

    • Example: 1.2

    • Example 1

  • {releaseName} β€” human-readable release name

    • Example: Cinnamon

    • Example: BigFeature

  • {appStoreBuildNumber} β€” build number as it appears in App Store Connect or Play Console

  • {ciBuildNumber} β€” build number as it appears in CI

Usage

  • Required:

    • either {version} or {versionConcise}

  • Not allowed:

    • None β€” all available token types are allowed

  • Required:

    • At least one of {version}, {versionConcise}, and {ReleaseName}

  • Not allowed:

    • {appStoreBuildNumber} and {ciBuildNumber}

  • If branch is versioned (i.e. branches are created per release)

    • Required:

      • either {version}, {versionConcise}, or {ReleaseName}

    • Not allowed:

      • {appStoreBuildNumber} and {ciBuildNumber}

  • If branch is static (same across all releases)

    • No token types are allowed

πŸš€
branch names
tags
feature affiliations