how to move folders in github

Easy Steps to Move Folders in GitHub

By Christopher Williams
AD

Ever found yourself wishing you could simply drag and drop folders from one place to another in GitHub, like you would on your local machine? While GitHub doesn't support this natively, there are a few methods to move folders around, ensuring your project's structure remains organized and intact. Let's explore the most effective ways to accomplish this.

Before we dive in, ensure you're comfortable with basic Git operations, as these methods involve using Git commands in your terminal or command prompt. If you're new to Git, consider familiarizing yourself with the basics before proceeding.

Moving Folders Using Git Actions: Clone & Re Clone

The most straightforward way to move GitHub folders involves cloning your repository, organizing your local files, then cloning the repository again with the updated folder structure. This method effectively 'moves' your folders by creating a new repository with the desired structure.

AD
How to Get Started With GitHub in 2026 and Build Real Projects Fast
How to Get Started With GitHub in 2026 and Build Real Projects Fast
How to move an entire folder in Linux / Unix - nixCraft
How to move an entire folder in Linux / Unix - nixCraft
How to Download Files and Folders From GitHub
How to Download Files and Folders From GitHub

However, this approach results in a new repository with a new URL, which might not be ideal if you want to keep your original repository's history and URL.

Step 1: Clone Your Repository

Begin by cloning your existing repository using the following command, replacing the URL with yours:

How to Create Your First Repository on Github
How to Create Your First Repository on Github
How to create repository on GitHub - The Tech Edvocate
How to create repository on GitHub - The Tech Edvocate
git clone https://github.com/username/repo.git

Step 2: Organize Your Local Folder Structure

Once cloned, organize your folders and files to the desired structure in your local repository. Delete unnecessary folders or move them where needed.

Step 3: Clone Your Repository Again

With the updated local folder structure, clone your repository again, ensuring the new clone has the updated folder structure.

AD

Renaming or Moving Folders with Git mv and git commit

For those who'd prefer to keep their original repository's history and URL, using Git's mv and commit commands is a more suitable approach. These commands allow you to rename, move, or delete files and folders, updating your repository's structure while preserving its history.

Remember, Git considers folder renaming and moving as file editing. Therefore, use these commands judiciously to avoid unnecessary changes in your repository's history.

Renaming or Moving a Folder

First, make sure you're in your repository's root directory, then use the following commands to rename or move your folder:

AD
git mv old-folder-name new-folder-name

Or, to move a folder from one location to another:

git mv old-location/new-folder-name new-location/new-folder-name

Committing the Changes

After moving your folder, you'll need to commit these changes to your repository. If there are no conflicting changes, your rewritten folder history will be preserved. Use the following commands to commit:

git commit -m "Message describing the folder move or rename"

Pushing Changes to GitHub

With both methods, once you've successfully moved your folders and committed the changes, push your updates to GitHub:

AD
git push origin master

Remember, if you're working with a team, ensure proper communication regarding these changes to avoid conflicts and preserve your repository's organized structure.

And there you have it! You've now learned how to move folders in GitHub, keeping your project organized and your repository history intact. Happy coding!

AD