Corporate logotype
  • Go to Support
  • Book a demo
Corporate logotype
  • Getting started
    • Migrating to Bitrise
      • Migrating from Jenkins to Bitrise
    • Signing up for Bitrise
      • Creating your first Workspace
      • Adding your first app
      • Getting started with iOS apps
        • Getting started with Android apps
          • Getting started with React Native apps
            • Getting started with Flutter apps
              • Getting started with Ionic/Cordova apps
                • Getting started with Expo apps
                  • Getting started with MacOS apps
                  • Infrastructure
                    • Build machines
                      • Configuring network access for Bitrise build machines
                      • Storage space on build machines
                      • Freeing up storage space on build machines
                      • Customizing build machines
                    • Build stacks
                      • Stack update policy
                      • Stack deprecation and removal policy
                      • Preinstalled tools on Bitrise stacks
                      • The Android/Linux/Docker environment
                      • Managing Java versions
                    • Code security
                      • Customizable enterprise build platforms
                        • Using your own Docker image
                          • Running your build locally in Docker
                          • Accounts
                            • Connecting to services
                              • The service credential user
                              • Connecting your GitHub/GitLab/Bitbucket account to Bitrise
                              • Connecting self-hosted GitLab instances
                              • Apple services connection
                              • Connecting to an Apple service with API key
                              • Connecting to an Apple service with Apple ID
                              • Connecting to an Apple Service with Step inputs
                              • Steps requiring Apple authentication
                            • SAML SSO in Bitrise
                              • Setting up Google SSO for Bitrise
                              • Setting up AD FS SSO for Bitrise
                              • Setting up Azure AD SSO for Bitrise
                              • Setting up Auth0 SSO for Bitrise
                              • Setting up Idaptive SAML SSO for Bitrise
                              • Setting up Okta SSO for Bitrise
                              • Setting up Ping Identity SSO for Bitrise
                              • Setting up OneLogin SSO for Bitrise
                            • Editing your profile settings
                              • Resetting your password
                              • Two-factor authentication
                                • Personal access tokens
                                  • Deleting your Bitrise account
                                • Workspaces
                                  • Creating Workspaces
                                  • Workspace billing and invoicing
                                    • Adding other users to Workspaces
                                      • Changing the owners of a Workspace
                                      • Workspace FAQ
                                    • Apps
                                      • Webhooks
                                        • Adding incoming webhooks
                                        • Adding a GitHub webhook
                                        • Adding a Gitlab webhook
                                        • Adding a Bitbucket webhook
                                        • Adding a Gogs webhook
                                        • Adding a Slack webhook
                                        • Adding a Visual Studio webhook
                                        • Adding an Assembla webhook
                                        • Adding a Deveo webhook
                                        • Adding outgoing webhooks
                                      • Configuring the repository URL and default branch
                                        • Configuring SSH keys
                                        • Adding team members to an app
                                          • User roles on app teams
                                            • Changing the owner of an app
                                              • Enabling the Bitrise Support user for your app
                                              • Apps with submodules or private repo dependencies
                                                • Public apps
                                                • Creating white label app versions
                                                • Steps and Workflows
                                                  • Steps
                                                    • Adding Steps to a Workflow
                                                    • Step versioning
                                                    • Step inputs
                                                    • Skipping Steps
                                                    • Enabling or disabling a Step conditionally
                                                    • Setting a time limit for Steps
                                                  • Developing your own Bitrise Step
                                                    • Developing a new Step
                                                    • Sharing Steps with all Bitrise users
                                                    • Verified Steps
                                                    • Creating your own Bitrise project scanner
                                                  • Workflows
                                                    • Default Workflows
                                                    • Creating a Workflow
                                                    • Managing Workflows
                                                    • Copying Workflows from one app to another
                                                  • Workflow recipes for Android apps
                                                    • (Android) Deploy to Visual Studio App Center
                                                    • (Android) Deploy to Firebase App Distribution
                                                    • (Android) Deploy to Google Play (Internal, Alpha, Beta, Production)
                                                    • (Android) Deploy to Bitrise.io
                                                    • (Android) Example CI Workflow
                                                    • (Android) Example nightly Workflow
                                                    • (Android) Example pull request Workflow
                                                    • (Android) Run instrumentation tests on virtual devices
                                                    • (Android) Example release Workflow
                                                    • (Android) Run Lint
                                                    • Turn on Gradle build profiling
                                                    • (Android) Run unit tests
                                                    • (Android) Run tests using the emulator
                                                  • Workflow recipes for iOS apps
                                                    • (iOS) Deploy to Visual Studio App Center
                                                    • (iOS) Cache CocoaPods dependencies
                                                    • (iOS) Deploy to App Store Connect / TestFlight
                                                    • (iOS) Example CI Workflow
                                                    • (iOS) Deploy to bitrise.io
                                                    • (iOS) Example pull request Workflow
                                                    • (iOS) Deploy to Firebase App Distribution
                                                    • (iOS) Example nightly Workflow
                                                    • (iOS) Run tests on a physical device
                                                    • (iOS) Run tests on a simulator
                                                    • (iOS) Install CocoaPods dependencies
                                                    • (iOS) Install Carthage dependencies
                                                    • (iOS) Example release Workflow
                                                  • Workflow recipes for cross-platform apps
                                                    • (React Native) Cache dependencies (node_modules)
                                                    • (React Native) Expo: Build using Turtle CLI
                                                    • (React Native) Run tests
                                                    • (React Native) Install dependencies
                                                    • (Flutter) Run tests
                                                    • (Flutter) Install Flutter SDK
                                                    • (Flutter) Run Dart Analyzer
                                                  • Generic Workflow recipes
                                                    • (iOS/Android) Send build status to Slack
                                                    • Cloning a Git repository
                                                    • Shallow clone a Git repository
                                                    • Example Gitflow release branch Workflow
                                                    • (iOS/Android) Send QR code to Slack
                                                    • Start builds from a parent Workflow
                                                    • Optimizing cache efficiency for pull request builds
                                                    • GitHub pull request: send the build QR code
                                                • Builds
                                                  • Configuring build settings
                                                    • Setting the stack for your builds
                                                    • Managing an app's bitrise.yml file
                                                    • Editing the app's bitrise.yml file
                                                    • Accessing a build's bitrise.yml file
                                                    • Selective builds
                                                    • Rolling builds
                                                    • Configuring email notifications
                                                    • Configuring Slack integration
                                                    • Setting your Git credentials on build machines
                                                    • Reporting the build status to your Git hosting provider
                                                  • Starting builds
                                                    • Starting builds manually
                                                    • Triggering builds automatically
                                                    • Scheduling builds
                                                    • Approving pull request builds
                                                    • Using the Trigger Map to trigger builds
                                                    • Starting parallel builds with a single trigger
                                                    • Skipping a given commit or pull request
                                                  • Caching
                                                    • Using caching in your builds
                                                    • Caching Cocoapods
                                                    • Caching Gradle
                                                    • Caching Maven
                                                    • Caching Ruby Gems
                                                    • Caching Homebrew installers
                                                  • Managing build files
                                                    • Uploading files for your builds
                                                    • Using files in your builds
                                                    • Using encrypted files in your builds
                                                    • Build artifacts online
                                                  • Environment Variables
                                                    • Secrets
                                                      • Build statuses
                                                      • Installing tools during a build
                                                        • Connecting to a VPN during a build
                                                          • Finding a specific build
                                                          • Build numbering and app versioning
                                                            • Build data and troubleshooting
                                                              • Build logs
                                                              • Remote access
                                                              • Debugging your build on your own machine
                                                              • Bitrise Checks on GitHub
                                                              • Monitoring your builds with Meercode
                                                              • Checking build details
                                                          • Code signing
                                                            • Android code signing
                                                              • Android code signing using the Android Sign Step
                                                              • Android code signing with Android Studio
                                                              • Android code signing in Gradle
                                                              • Downloading a keystore file
                                                            • iOS code signing
                                                              • Collecting and exporting code signing files with codesigndoc
                                                              • iOS code signing with automatic provisioning
                                                              • Managing iOS code signing files - manual provisioning
                                                              • Creating a signed IPA for Xcode projects
                                                              • Signing an IPA with multiple code signing identities
                                                              • iOS code signing for Ionic and Cordova projects
                                                              • Protecting your code signing files
                                                              • Generating iOS code signing files
                                                              • Exporting iOS code signing files manually
                                                              • Troubleshooting iOS code signing
                                                          • Testing
                                                            • Test Reports
                                                              • Exporting to Test Reports from any Step
                                                                • Running Xcode tests
                                                                  • Installing an ipa file from the public install page
                                                                    • Registering a test device
                                                                      • Device testing for iOS
                                                                        • Android unit tests
                                                                          • Device testing for Android
                                                                            • Running tests in the Visual Studio App Center
                                                                            • Running Detox tests on Bitrise
                                                                            • Deploying
                                                                              • Android deployment
                                                                                • Deploying Android apps to Bitrise and Google Play
                                                                                • Deploying apps to Huawei AppGallery
                                                                                • Generate and deploy multiple flavor APKs in a single workflow
                                                                                • Generating and deploying Android app bundles
                                                                                • Exporting a universal APK from an AAB
                                                                              • iOS deployment
                                                                                • Deploying an iOS app to Bitrise.io
                                                                                • Deploying an iOS app for external testing
                                                                                • Deploying an iOS app to iTunes Connect
                                                                                • Deploying an iOS app for simulators
                                                                              • Bitrise OTA app deployment
                                                                                • Deploying with Ship
                                                                                  • Getting started with Ship
                                                                                  • Configuring an app for publishing with Ship
                                                                                  • Installing an app on a test device with Ship
                                                                                  • Publishing an app to a store with Ship
                                                                                  • Using Ship for apps built with cross-platform frameworks
                                                                                  • App details in Ship
                                                                                  • Ship notifications
                                                                                • Deploying apps to Applivery
                                                                                  • Deploying apps to DeployGate from Bitrise
                                                                                  • Deploying your app to Appaloosa
                                                                                  • Deploying to TestFairy with Bitrise
                                                                                • Build Insights
                                                                                  • Getting started with Insights
                                                                                    • Available metrics in Insights
                                                                                      • Test stats in Build Insights
                                                                                      • Bitrise CLI
                                                                                        • Installing and updating the Bitrise CLI
                                                                                          • Adding a new app from a CLI
                                                                                          • Initializing a Bitrise project locally
                                                                                          • Installing and upgrading the offline Workflow Editor
                                                                                            • Running your first local build with the CLI
                                                                                            • Managing Secrets locally
                                                                                          • API
                                                                                            • Authenticating with the Bitrise API
                                                                                            • Pagination of API calls
                                                                                            • Adding and managing apps
                                                                                              • Triggering and aborting builds
                                                                                                • Incoming and outgoing webhooks
                                                                                                  • Managing iOS code signing files
                                                                                                    • Managing files in Generic File Storage
                                                                                                      • Managing build artifacts
                                                                                                        • API reference
                                                                                                      • References
                                                                                                        • Basics of bitrise.yml
                                                                                                        • Customizing the bitrise.yml config
                                                                                                        • Workflow reference
                                                                                                        • Steps reference
                                                                                                          • Step reference/ID format
                                                                                                          • Step data in the bitrise.yml file
                                                                                                          • Step properties
                                                                                                          • Step inputs reference
                                                                                                          • Step outputs reference
                                                                                                        • Available environment variables
                                                                                                        • Bitrise tools
                                                                                                      • Go to Support
                                                                                                      • Book a demo
                                                                                                      print
                                                                                                      • Prev
                                                                                                      • Next
                                                                                                      • Welcome to Bitrise documentation!
                                                                                                      • Builds
                                                                                                      • Starting builds
                                                                                                      • Triggering builds automatically

                                                                                                      Triggering builds automatically

                                                                                                      You can automatically trigger builds by specifying a trigger event and a workflow. You can specify multiple triggers, and add new triggers or remove existing ones any time you wish.

                                                                                                      You can manage the triggers in the Triggers section of the Workflow Editor or you can directly edit the bitrise.yml of your app to set them up. In this section, we cover how to set up and manage triggers on the website UI!

                                                                                                      Triggering builds with code push

                                                                                                      By creating a trigger on code push, you can configure Bitrise to automatically start a build every time code is pushed to your repository. You can specify both the branch of the repository and the Workflow that should run.

                                                                                                      Webhooks for triggering builds

                                                                                                      Triggering builds automatically requires an incoming webhook set up with the hosting service of your repository. Read more in the Webhooks section.

                                                                                                      1. Open your app on bitrise.io.

                                                                                                      2. Go to the Workflows tab.

                                                                                                      3. Go to the Triggers tab.

                                                                                                      4. Select the PUSH option.

                                                                                                        Triggering builds with code push
                                                                                                      5. Click + ADD TRIGGER.

                                                                                                      6. In the PUSH BRANCH window, type in the name of the branch (for example, master. Make sure there are no spelling errors, otherwise the trigger won’t work.

                                                                                                        Using patterns when specifying a branch or tag

                                                                                                        The * symbol can be used in your configured triggers as a wildcard in branch or tag names. It can also be used in patterns. For example, the pattern *-dev can be used for any branches or tags with the suffix -dev. Please note that when there are multiple triggers, only the first matching trigger will start a workflow.

                                                                                                      7. Select the Workflow you wish to trigger (for example, primary).

                                                                                                      8. Click Save in the top right corner.

                                                                                                      You’re done! From now on, if code gets pushed to the selected branch of your app’s repository, Bitrise will trigger a build with the selected Workflow!

                                                                                                      Triggering builds with pull requests

                                                                                                      You can set up a trigger so that every time a pull request is opened from a specified source branch to a specified target branch of your repository, a build is automatically triggered on Bitrise.

                                                                                                      Webhooks for triggering builds

                                                                                                      Triggering builds automatically requires an incoming webhook set up with the hosting service of your repository. Read more in the Webhooks section.

                                                                                                      1. Open your app on bitrise.io.

                                                                                                      2. Go to the Workflows tab.

                                                                                                      3. Go to the Triggers tab.

                                                                                                      4. Select the PULL REQUEST option.

                                                                                                        Getting started
                                                                                                      5. In the default trigger, click the SOURCE BRANCH and TARGET BRANCH options.

                                                                                                        Click + ADD TRIGGER.

                                                                                                      6. Type the names of the source branch and the target branch. Make sure there are no spelling errors, otherwise the trigger won’t work.

                                                                                                        You can leave either the source or target branch fields, or both, empty: the trigger will work accordingly. For example, if you leave both empty, as is the default with new apps, every pull request will trigger a build.

                                                                                                        Using patterns when specifying a branch or tag

                                                                                                        The * symbol can be used in your configured triggers as a wildcard in branch or tag names. It can also be used in patterns. For example, the pattern *-dev can be used for any branches or tags with the suffix -dev. Please note that when there are multiple triggers, only the first matching trigger will start a workflow.

                                                                                                      7. Select the Workflow you wish to trigger (for example, primary).

                                                                                                      8. Click Save in the top right corner.

                                                                                                      And you’re done! From now on, if a pull request is opened in your repository, Bitrise will trigger a build with the selected workflow!

                                                                                                      Triggering builds with Git Tags

                                                                                                      You can specify a pattern for your Git Tags to trigger a specific workflow. This is a good way to build and deploy your app in a specific state. And it’s very easy to set up!

                                                                                                      Webhooks for triggering builds

                                                                                                      Triggering builds automatically requires an incoming webhook set up with the hosting service of your repository. Read more in the Webhooks section.

                                                                                                      Note that certain providers, such as GitLab, require Tag Push events to be specifically enabled in the webhook setup.

                                                                                                      1. Open your app on bitrise.io.

                                                                                                      2. Go to the Workflows tab.

                                                                                                      3. Go to the Triggers tab.

                                                                                                      4. Select the TAG option.

                                                                                                        Triggering builds with Git Tags
                                                                                                      5. Click + ADD TRIGGER.

                                                                                                      6. In the TAG window, add the tag that you wish to trigger a build.

                                                                                                        Using patterns when specifying a branch or tag

                                                                                                        The * symbol can be used in your configured triggers as a wildcard in branch or tag names. It can also be used in patterns. For example, the pattern *-dev can be used for any branches or tags with the suffix -dev. Please note that when there are multiple triggers, only the first matching trigger will start a workflow.

                                                                                                      7. Select the Workflow you wish to trigger (for example, primary).

                                                                                                      8. Click Save in the top right corner.

                                                                                                      And you’re done!

                                                                                                      In this section:
                                                                                                      See also:
                                                                                                      • Webhooks
                                                                                                      • Starting builds manually
                                                                                                      • Starting parallel builds with a single trigger
                                                                                                      • Triggering builds automatically
                                                                                                      • Triggering builds with code push
                                                                                                      • Triggering builds with pull requests
                                                                                                      • Triggering builds with Git Tags

                                                                                                      Search results

                                                                                                        No results found

                                                                                                        Was this helpful?

                                                                                                        Would you like to provide feedback? Just click here to suggest edits.

                                                                                                        • Prev
                                                                                                        • Next
                                                                                                        © 2022
                                                                                                        Publication date: