Managing your repositories efficiently includes removing projects that are no longer needed. Whether it’s a test project, an outdated codebase, or a duplicate repository, GitLab allows you to delete projects safely and permanently.
This guide walks you through how to delete a project in GitLab via the web interface.
Important: Deleting a project is irreversible!
Before proceeding, ensure you have backups or are certain you no longer need the project, as deletion permanently removes all repository data, issues, merge requests, wiki pages, and more.
Step 1: Log In to GitLab
Open your web browser and go to your GitLab instance (e.g., gitlab.com).
Sign in with your username and password.
Step 2: Navigate to Your Project
From your GitLab dashboard:
- Click on Projects in the sidebar or top menu.
- Select Your Projects.
- Find and click on the project you want to delete.
Step 3: Access Project Settings
Once inside your project:
- Click on Settings (gear icon) in the left sidebar.
- Then select General from the submenu.
Step 4: Expand the “Advanced” Section
Scroll down to the bottom of the General Settings page.
Click the Expand button next to Advanced to reveal additional options.
Step 5: Delete the Project
At the bottom of the Advanced settings:
- You’ll see the Remove project section.
- Click the red Remove project button.
Step 6: Confirm Project Deletion
GitLab will ask you to confirm the deletion by typing the project name.
- Carefully type the exact project name.
- Click Confirm.
Step 7: Project Deleted
Your project and all its data will be permanently deleted.
Summary
| Step | Action |
|---|---|
| Log in to GitLab | Access your GitLab account |
| Navigate to project | Open the project you want to delete |
| Open Settings > General | Access project settings |
| Expand Advanced | Find the delete option |
| Remove Project | Confirm by typing project name |
Final Thoughts
Deleting projects helps keep your GitLab workspace organized and clutter-free. Just remember to double-check before confirming, as the action cannot be undone.
