How to Create/Access Subfolders In TortoiseSVN
How to Create/Access Subfolders In TortoiseSVN
This article explains a common TortoiseSVN workflow: creating a subfolder in an existing SVN repository, then checking out that specific subfolder into a new local folder. This is a practical approach when you want a clean working copy that maps to a single project folder inside a larger repository.
A typical use case is when a repository has a root URL (sometimes referred to as the repository “top level”) and you want to work only within a specific directory such as Project without checking out the entire root.
Note: This process assumes you already have access permissions for the repository and that you can authenticate when prompted. If you cannot browse or check out the repository, you likely need credentials or access granted by your SVN administrator.
Before You Start
Before following the steps below, confirm that the folder you are working in is already linked to the repository root URL. In practical terms, this means you are inside a working copy (or a folder structure) that is already associated with the SVN repository.
Also confirm you know the correct repository URL (root URL) and the intended subfolder name you plan to use (for example, Project). SVN URLs are typically case-sensitive and must be entered exactly as expected by the repository.
The instructions below preserve the original step sequence and URLs from the existing content, and add context so the page is easier to understand and more searchable.
Step-by-Step: Create a Subfolder and Check It Out
The workflow below has two distinct parts: first you create a subfolder in the repository (for example, Project), then you create a separate local folder (for example, Backup) and perform an SVN Checkout… against the repository URL that includes the new subfolder path.
This separation is useful because it allows you to maintain multiple working copies, isolate project scopes, and avoid checking out more content than you need. It can also reduce local disk usage and keep your working folder structure cleaner.
Follow the steps below exactly. When prompted for credentials, use the username/password that has access to the repository path you are checking out.
Note: This article assumes that the user already has full access to the repository.
- Within a folder already linked to the root URL of the repository (http://www.yoursvn.com/CVS/), create a new subfolder (e.g. Project).
- Create a completely new folder at a different location, which will link to the newly created subfolder in the repository. (e.g. Backup)
- Right-click the folder and select SVN Checkout…
- For the URL of the repository use the rootURL/subfolder (e.g. http://www.yoursvn.com/CVS/Project/)
- Select OK.
- Enter the username and password.
After the checkout completes, your new local folder should contain the working copy for that specific subfolder path. From that point onward, SVN operations (Update, Commit, Diff, Log, etc.) apply to that working copy as usual.
Common Pitfalls and Troubleshooting
If the checkout fails, the most common causes are an incorrect URL path (for example, missing the trailing folder name), a permissions issue (no access to the subfolder path), or authentication problems (incorrect username/password).
If your repository has a more structured layout (for example separate folders for trunk/branches/tags), make sure you are checking out the correct path for your intended workflow. In all cases, the URL entered during checkout determines what content you receive locally.
If you are working behind a proxy, VPN, or restrictive network, connectivity can also affect the checkout process. In that case, validating basic access to the repository URL in advance can save time.
FAQ: Subfolders in TortoiseSVN
The questions below are included to improve AI searchability and to provide quick clarification for common scenarios.
What does it mean to “check out a subfolder” in SVN?
It means your working copy is mapped to a repository URL that includes a folder path (for example, rootURL/subfolder), so you only download and work with that part of the repository rather than the entire repository root.
Do I need access to the entire repository to check out a subfolder?
You need access rights for the repository path you are checking out. If your account does not have permissions for that path, the checkout may fail or you may be prompted with authorization errors.
Why create a new local folder before running SVN Checkout?
Creating a dedicated local folder helps keep your working copy organized and avoids mixing multiple working copies or unrelated files in a single directory. The checkout process will populate the folder with the repository content for the selected URL.
What URL should I enter in TortoiseSVN for SVN Checkout?
Enter the repository URL that points to the specific folder you want (for example, rootURL/subfolder). The exact URL format depends on your SVN server and repository structure.
What should I do if I get prompted for a username and password repeatedly?
Repeated prompts typically indicate incorrect credentials, missing permissions, or an authentication configuration issue. Confirm you have access to the repository and that you are using the correct credentials for the SVN server.