Adding a Git tag with app version

How to add a Git tag to your apps

You can use Codemagic to create a Git tag and push it to your repository.

Note: Pushing Git tags from Codemagic to your repository requires write access to the repository. Depending on the Git service and authentication method, Codemagic may not have write access to your repository, and you may need to grant it separately in your Git service settings. We recommend that you create a dedicated app password / personal access token for Codemagic.

  • For repositories hosted on Bitbucket, create an app password with write permission for repositories.
  • For repositories hosted on GitHub, create a personal access token with repo scope.
  • For repositories hosted on GitLab, create a personal access token with write_repository scope.

Configure environment variables

To allow Codemagic to access your repository, please save the app password or the personal access token in Codemagic.

  1. Open your Codemagic app settings, and go to the Environment variables tab.

  2. Enter the desired Variable name, e.g. APP_PASSWORD.

  3. Enter the value as Variable value.

  4. Enter the variable group name, e.g. repo_credentials. Click the button to create the group.

  5. Make sure the Secure option is selected.

  6. Click the Add button to add the variable.

  7. Add the variable group to your codemagic.yaml file

          - repo_credentials

Publishing Git tags

To create and publish git tags, add the following pre-publish script, replacing the placeholders with your actual service details.

    - name: Push git tags
      script: | 
        #!/usr/bin/env bash
        set -e # exit on first failed command
        set -x # print all executed commands to the log

        if [ "$CM_BUILD_STEP_STATUS" = "success" ]
          git tag $new_version
          git push "https://your-username:$" --tags


  • BUILD_NUMBER is the built-in environment variable that holds the total count of builds for this project in Codemagic.
  • your-username is your Git service username
  • APP_PASSWORD is the name of the environment variable that holds your app password / personal access token.
  • is the name of your Git service, e.g.,, or
  • your-repo is the name of your repository

Before creating the tag, the script will check if the build was successful.

Note: Make sure to use the https repository URL for pushing. Using the ssh format is not supported with app passwords or personal access tokens.