To delete a repository on GitHub, navigate to the repository’s Settings tab, scroll down to the Danger Zone section, click “Delete this repository,” and confirm the deletion by typing the full repository name. This action is permanent and cannot be reversed.
Quick Steps:
- Log in to your GitHub account
- Navigate to the repository you want to delete
- Click the Settings tab at the top right of the repository page
- Scroll down to the Danger Zone section
- Click “Delete this repository”
- Click “I want to delete this repository”
- Type the full repository name to confirm
- Click “Delete this repository” to finalize
Why GitHub Requires Confirmation for Repository Deletion
GitHub implements a multi-step confirmation process for repository deletion because the action is permanent and irreversible. Once deleted, all code, commit history, issues, pull requests, and wikis associated with the repository are permanently removed from GitHub’s servers.
This protection mechanism prevents accidental deletions that could result in significant data loss. The requirement to type the full repository name ensures you’re intentionally deleting the correct repository, especially important when managing multiple projects.
Detailed Step-by-Step Guide
Step 1: Access Your Repository
Log in to your GitHub account and navigate to the main dashboard. You’ll see a list of your repositories on the left side of the screen. Click on the repository you want to delete to open its main page.
Step 2: Open Repository Settings
Once you’re on the repository page, locate the Settings tab in the navigation menu at the top right of the page. Click on Settings to access the repository configuration options. Note that you must have admin permissions on the repository to access these settings.
Step 3: Navigate to the Danger Zone
Scroll down to the bottom of the Settings page until you reach the Danger Zone section. This area contains destructive actions that permanently affect your repository. You’ll see warnings indicating that deletion is permanent and not reversible.
Step 4: Initiate Repository Deletion
In the Danger Zone, click the “Delete this repository” button. A confirmation dialog will appear with another warning about the permanent nature of this action. Click “I want to delete this repository” to proceed to the final confirmation step.
Step 5: Confirm Deletion by Typing Repository Name
GitHub will prompt you to type the full repository name in the format username/repository-name to confirm your intention. Type the exact name as shown, then click “Delete this repository” to permanently remove it. The repository will be immediately deleted from GitHub.
What Happens After Repository Deletion
After deleting a repository, all associated data is permanently removed from GitHub’s servers. This includes the entire commit history, all branches, issues, pull requests, project boards, wiki pages, and GitHub Actions workflows. If the repository was forked from another repository, the original and other forks remain unaffected.
Any links to the deleted repository will return a 404 error. If other users had cloned the repository to their local machines, those local copies remain intact, but they can no longer push changes or sync with the remote repository on GitHub.
Common Issues & Solutions
Problem: Settings tab is not visible
Solution: You need admin or owner permissions to access repository settings. Contact the repository owner to request deletion or to grant you admin permissions.
Problem: Delete option is grayed out or unavailable
Solution: Some organization repositories may have protection policies preventing deletion. Check with your organization administrator, or verify you’re not trying to delete a default branch without proper permissions.
Problem: Unable to type the repository name correctly
Solution: The repository name is case-sensitive and must include your username in the format username/repository-name. Copy the exact text shown in the confirmation dialog to ensure accuracy.
Problem: Repository has pending pull requests
Solution: GitHub allows deletion even with open pull requests, but you should inform collaborators before deleting. Consider closing or merging outstanding pull requests first to avoid confusion.
FAQ
Can I recover a deleted GitHub repository?
No, GitHub repository deletion is permanent and irreversible. Once deleted, there is no way to recover the repository through GitHub’s interface. However, if you have a local clone on your computer, you can create a new repository and push your local copy back to GitHub.
Will deleting a repository affect my GitHub statistics?
Yes, deleting a repository will remove its contributions from your GitHub profile statistics. Your contribution graph will no longer show commits made to that repository, and any stars or forks associated with it will be permanently lost.
What happens to forks when I delete the original repository?
When you delete a repository that has been forked by other users, those forks remain intact and continue to exist independently. The oldest fork typically becomes the new network root, and other forks maintain their connection to the fork network.
Can I delete a repository from the GitHub mobile app?
No, repository deletion is not available through the GitHub mobile app. You must use the GitHub website through a desktop or mobile browser to access the Settings page and delete a repository.
How do I archive a repository instead of deleting it?
In the same Settings page, look for the “Archive this repository” option above the Danger Zone. Archiving makes the repository read-only while preserving all its content, providing a safer alternative to permanent deletion when you want to retire a project without losing its history.
