TaxDome logo

Help Center

Sign Up Log In

Import documents using the web migration tool

TaxDome’s web-based migration tool lets you upload a large collection of client documents from your computer directly in the browser—no app installation required. It scans a local folder, automatically matches subfolders to your TaxDome accounts by name, and uploads files in resumable batches so you can pause and continue at any time.

note icon

Note

The migration tool is available in Google Chrome only, to team members with Manage documents access right .

Before you start

Make sure:

  • Your client files are accessible to Chrome—either saved on your computer, in a cloud-synced folder (OneDrive, Dropbox, or Google Drive with offline sync enabled), or on an RDP environment where you’ll be running Chrome. If your files are only on a shared office drive or server, download them to your computer first

  • TaxDome accounts already exist for each client you plan to migrate. The tool matches folder names to account names—any folder without a match is flagged and can be assigned manually during the mapping step

tip icon

Tip

See our guide on migrating your client list to transfer your entire client database in bulk.

Step 1: Open the migration tool

  1. Open Google Chrome and log in to TaxDome.

  2. Go to Documents > Client docs from the left menu bar and select Migrate documents.

Step 2: Select a folder

  1. Click Select folder.

  2. In the browser’s file picker, navigate to the top-level folder that contains your client folders—one subfolder per client—and click Select.

The tool scans the folder and displays all subfolders found, along with the TaxDome account each one was matched to.

Step 3: Review and adjust the mapping

Before any files are uploaded, the tool shows a full mapping preview—one row per client folder. Review each row and make any needed corrections before starting the upload.

  • Matched rows: confirm the account shown is correct

  • Unmatched rows: click the searchable dropdown in that row and select the correct account

  • No account yet: create the account in TaxDome first, then return to assign it

Once you’ve reviewed all rows, click Start upload.

tip icon

Tip

Not all accounts need to be matched before you start. You can skip unmatched folders for now, run the migration, and create the missing accounts later. When you re-run the migration with the same folder, already uploaded files are skipped automatically—only the previously skipped folders will be processed.

Step 4: Monitor the upload

The tool uploads files in batches of approximately 500 MB. Progress is displayed per client folder.

  • Oversized files are flagged in the tool and in the migration report and will not be uploaded.

  • Unsupported file types and empty folders are skipped automatically. See this article for the full list.

You can download the migration report (CSV file) at any point during or after the upload. It lists the status of every file, including any that were skipped or flagged.

What to expect after the upload

Once the migration is complete, each client account’s Docs tab contains an Imported folder with the original subfolder structure preserved inside it.

The Imported folder is hidden from clients by default—only firm users can see it. To share specific files or folders with clients, update the visibility settings manually.

If you need to re-run the migration—for example, to upload a second batch or fix a mapping error—select the same folder again. Files that were already uploaded are detected and skipped, so no duplicates are created.

Troubleshooting

What you’re seeing Fix
Page looks frozen after selecting a folder This is normal on large folders—the scan is still running.
Upload stalls after you switch away from the tab Keep the browser tab open and in the foreground while the upload runs.
A file shows “Uploading” indefinitely Refresh the page (F5) and select the same folder again—the migration resumes without creating duplicates.
Every file for one specific client fails This usually points to an issue with that account rather than the tool. Contact support to check it while the rest of the migration continues normally.
The upload was interrupted (tab closed, connection lost) Reopen the migration tool and select the same folder—already-uploaded files are detected and skipped. This only works on the same computer and browser where you started.
A file has the same name but different content than what’s already in TaxDome It isn’t overwritten. It’s flagged in the migration report for you to review manually.
Some files fail to upload on Windows This can happen if the file name contains special characters like or &, or if it’s stored in too many nested subfolders. Rename the affected files or simplify the folder structure, then re-run the migration.

Was this article helpful?

Share

Link copied Share on linkedin Share on facebook