Skip to main content

Editing the app's bitrise.yml file

Abstract

You can edit the file on bitrise.io, in the graphical Workflow Editor, or you can download it and edit it locally. Whenever you modify a Workflow or a Step in the Workflow Editor, you're indirectly editing the app's bitrise.yml configuration file.

Whenever you modify a Workflow or a Step in the Workflow Editor, you're indirectly editing the app's bitrise.yml configuration file. However, if you prefer, you can edit the file directly, in YAML.

Important

This requires some familiarity with the structure of the bitrise.yml file. Read more: Basics of bitrise.yml

You can edit the file on bitrise.io, in the graphical Workflow Editor, or you can download it and edit it locally.

Editing the bitrise.yml file online

You can edit your build config in yml format in the bitrise.yml editor if you go to your app’s Workflow Editor and click the bitrise.yml tab.

Managing an app's bitrise.yml configuration

  • Fold and unfold with the - and + signs.

  • Press Ctrl/Cmd + F for search and replace where you can search with RegExp, Match Whole Word, case-sensitive, case-insensitive, or to search only in the selected section.

  • Use the preview sidebar on the right for easier navigation.

To save your changes, click Save in the top right corner.

To download the current bitrise.yml file, click Download currently saved config. Alternatively, you can simply select certain sections of the file and copy those into either a local bitrise.yml file or into another app's bitrise.yml file.

Editing the bitrise.yml file locally

Our yml scheme is shared on schemastore. This means that syntax highlight and auto-completion is available for the following files if you edit them locally:

  • bitrise.yml

  • step.yml

  • bitrise.json

The following editors support the auto-complete feature:

  • IntelliJ IDEA

  • PhpStorm

  • PyCharm

  • Rider

  • RubyMine

  • Visual Studio 2013+

  • Visual Studio Code

  • Visual Studio for Mac

  • WebStorm

  • JSONBuddy

    autocomplete.png
In this section:

A Workflow is a collection of Steps, Environment Variables, and other configurations. When Bitrise starts a build, it runs one or more Workflows according to the configuration defined in the bitrise.yml file.

A Step is a block of script execution that encapsulates a build task on Bitrise: the code to perform that task, the inputs and parameters you can define for the task, and the outputs the task generates.