Stop building a project on CircleCI
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. |
| This feature is supported for orgs that use OAuth authentication. Check your Organization slug at . OAuth authenticated orgs are structured as follows:
This feature is not supported if your organization slug is in the following format:
For an overview of feature support, see the VCS integration overview 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. Only organization admins and project admins can delete projects.
-
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).
-
Scroll to the bottom of the Overview page and select Delete Project and reconfirm your choice in the popup.
If you encounter an error, 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.