Documentation structure for LLMs (llms.txt)
CircleCI Logo

Stop building a project on CircleCI

20 days ago
Cloud Server v4+

Introduction

This page outlines how to stop builds for a project on CircleCI.

For how this option fits with Block all new work, cancelling running workflows, and follower behavior during an incident, see Pause or Stop Pipelines During an Incident.

Stop building a project

The Stop Building option does not automatically remove all project data from the CircleCI databases. To remove all project data from CircleCI, see the Delete a Project documentation.

This feature is supported for orgs that use OAuth authentication.

Check your Organization slug at Organization settings  Overview. OAuth authenticated orgs are structured as follows:

  • github/<your-org-name> or gh/<your-org-name>

  • bitbucket/<your-org-name> or bb/<your-org-name>

This feature is not supported if your organization slug is in the following format:

  • circleci/<UID>.

For an overview of feature support, see the VCS Integration Overview page.

Stop Building removes all project followers, cancels all running workflows in the background, and removes VCS integration (webhook and deploy key). If you only want to prevent new pipelines while keeping the project connected and letting in-progress workflows finish, use Block All New Work in Advanced project settings instead.

If you are using the GitHub OAuth App or Bitbucket Cloud, to stop building one of your projects on CircleCI, follow these steps:

  1. Go to the Project Settings page in the CircleCI web app for the project you want to stop.

  2. Scroll to the bottom of the Overview page and select Stop Building. You will need to reconfirm your choice in the popup.

Stop building button in Project settings > Overview
Figure 1. Stop Building button in Project settings > Overview
If you want to start building this project again, just go to the Projects page in the web app and select Set Up Project and follow the set up steps.