Stop building a project on CircleCI

Cloud

Introduction

This page outlines how to stop builds for a project on CircleCI, and how to delete a project when required.

Stop building a project

The Stop Building option will not automatically remove all project data from the CircleCI databases. To remove all project data from CircleCI you need to contact CircleCI support, as detailed in the Delete a project from CircleCI section.

The Stop Building option is supported for GitHub OAuth and Bitbucket Cloud integrations with CircleCI. Stop Building is not supported for GitLab, GitHub App or Bitbucket Data Center projects. To find out if you authorized through the GitHub OAuth app or the CircleCI GitHub App, see the GitHub App integration page.

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

Go to the Project Settings page in the CircleCI web app for the project you want to stop.
Scroll to the bottom of the Overview page and select Stop Building. You will need to reconfirm your choice in the popup.

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.

Delete a project from CircleCI

If you want to remove a project from your CircleCI account, follow the steps below. Deleting a project will remove the complete build history. Project deletion requests must be submitted or approved by an organization admin.

Follow the instructions for your VCS integration to unlink the project from your account.
Remove webhooks and deploy keys created by CircleCI from your repository. For guidance, see this Support Article.

Remove webhooks and deploy keys created by CircleCI from your repository. For guidance, see this Support Article.
In the CircleCI web app, select the organization associated with the project you want to remove.

Select the project you want to remove from the project cards. If you do not see your project, select Projects in the sidebar and find it in the list.

Select Project Settings (or the ellipsis next to your project () and then select Project Settings).

Select Triggers from the sidebar and delete all triggers associated with your project.

If you do not see Triggers in the sidebar, your project is integrated using either GitHub OAuth or Bitbucket Cloud and these steps do not apply.

Select Pipelines from the sidebar and delete all pipelines associated with your project.
In the CircleCI web app, select the organization associated with the project you want to remove.

Select the project you want to remove from the project cards. If you do not see your project, select Projects in the sidebar and find it in the list.

Select Project Settings (or the ellipsis next to your project () and then select Project Settings).

Select Triggers from the sidebar and delete all triggers associated with your project.

If you do not see Triggers in the sidebar, your project is integrated using either GitHub OAuth or Bitbucket Cloud and these steps do not apply.

Select Pipelines from the sidebar and delete all pipelines associated with your project.
Open a new support request with details of the project that you wish to remove. Choose the "Build Failure/Configuration Help/Service Issue" option when opening the request. For more information on submitting support requests, see this support article.

Suggest an edit to this page

Make a contribution

Learn how to contribute

Still need help?

Ask the CircleCI community

Join the research community

Visit our Support site

Stop building a project on CircleCI

On This Page

Introduction