This article is about General Codeship Configuration.

Skipping builds

You will need about one minute to read this article.

Skipping Builds

You can skip builds on both Codeship Basic and Codeship Pro by using a special commit directive.

Skipping On Certain Branches

You can use the Branches tab in your Project Settings to exclude certain branches from running builds.

Exclude branches from running builds

Note that you can also choose to only run builds on certain branches by using the other toggle on the Branches tab as well.

Skipping Via Commit Message

You can add either of the following skip directives to the commit message of the last commit before you push and that push will be ignored:

  • --skip-ci
  • --ci-skip
  • [skip ci]
  • [ci skip]

Skipped builds do not have a build record and will not show up in the Codeship UI. They will also not count towards the concurrent builds or monthly build limits for users.

Ignore pull request merges

When you merge a pull request you can add one of the skip directives to the commit message as well.

Skipping Via A Step Tag on Pro

On Codeship Pro, in addition to using a commit message, you can also de-facto skip builds by making sure that every step in your codeship-steps.yml file has a tag, which limits that step to a certain branch. You can learn more about limiting your steps to a certain branch codeship-steps.yml documentation.

Need more help?

Contact our support team or post on Stack Overflow using the tag #codeship. Did you check the status page and changelog?

There are also several code examples and sample projects available for you to get started with.

Article not helpful?

Does this article need improvement? If so, please send feedback or submit a pull request!