Migration: guide
Help release c4e6d48f22a45602 · Generated 22 November 2026. Online at docs.mycadesk.in/modules/migration/.
Help explains how the software works and is not professional advice; refer to the statute or notification.
Moving to the app and taking your data out
How a firm brings its clients and past work into the app (imports, the onboarding wizard, assisted migration), edits lists in Excel, and exports all its data at any time.
The migration area helps a firm move in, and makes sure it can always move out.
Moving in
- Imports (
/migration/imports): bring in clients from the platform template or your own spreadsheet, client details from ITR JSON and e-TDS files, and a tracker of returns filed before you moved. Every import is checked, dry-run and only then applied: Import clients and past work (sign in to read). - The onboarding wizard walks a new firm through its set-up steps up to go-live, with a
checklist (switch
ff.migration.wizard). Its profile-gap threshold is a firm setting (Migration and onboarding settings (sign in to read)). - Assisted migration (switch
ff.migration.assisted): a project to track a larger move with the platform's support team, from samples to sign-off and cut-over: Assisted migration projects (sign in to read).
Imports never keep passwords or PINs found in a file (the column is dropped and the file deleted), and Aadhaar numbers are masked.
Working in Excel
Excel round trip (switch ff.migration.grid_roundtrip) lets you download a list as a signed
workbook, change it and upload it back. Nothing changes until you check and apply the changes:
Change lists in Excel and upload them back.
Moving out
Export all data (/migration/exit-export) gives the owner or partners one archive of
everything the firm holds, even if the subscription has lapsed: Export all the firm's data (sign in to read).
Switches
The onboarding wizard, assisted migration and the Excel round trip are switched on per firm while they are rolled out. A page whose feature is off says so.
Change lists in Excel and upload them back
Download a list as a signed Excel workbook, change it, upload it back, check the changes and apply them; rows someone changed since your download are refused and nothing is ever deleted.
Excel round trip (/migration/grids) lists the spreadsheets available to you. Download one as
a signed workbook, change it in Excel, and upload it back. Nothing changes until you check the
changes and apply them. It is switched on per firm.
Steps
- Open Excel round trip and download the list you need. A list that holds client data asks you to confirm it is you (Step-up).
- Change the visible cells. Do not delete hidden sheets or columns, and do not copy the data into another workbook: they carry the signature that identifies each row.
- Upload the workbook with Upload the changes. The app checks the signatures and lists each row's result.
- Choose Check the changes, read the results, then Apply the changes.
Row results
| Result | Meaning |
|---|---|
| Valid | Will be applied |
| Unchanged | Nothing to apply |
| Changed since export | Someone changed the record after your download; refused |
| Error | A locked column was changed, the row's signature does not verify, or the record is no longer visible to you |
Rows you deleted from the workbook are ignored, not deleted: the round trip never deletes records. Some lists are export-only, and some do not accept new rows.
Warning
A workbook can only be uploaded to the firm that exported it, and only for the same version of the list. After a release that changes a list, download a fresh workbook.