Migration Troubleshooting & Tips
Common Issues
- "Membership not found" during People import — The membership name in your file doesn't match any imported membership. Check for typos, extra spaces, or abbreviations. The AI uses fuzzy matching but large differences may not resolve.
- "Coach not found" during Classes import — The coach email doesn't match any imported person. Ensure coaches were included in Step 4 with the correct email address.
- Duplicate email addresses — Each person must have a unique email. Duplicates are flagged during the review step and must be resolved before importing.
- Date format errors — Use YYYY-MM-DD format for dates (e.g. "2024-07-01"). Other formats may be misinterpreted.
- Empty or blank rows — Remove any trailing blank rows from your spreadsheet before uploading. These can cause unexpected validation errors.
Best Practices
- Download the example CSV first — Use the template for each step to see the exact columns and format expected.
- Start small — If you have thousands of records, test with a small batch first (10-20 rows) to verify the mapping works correctly.
- Complete steps in order — Skipping steps can cause mapping failures. For example, importing people before memberships means auto-mapping won't work.
- Screenshots work too — If you don't have a digital export, you can take a screenshot of a table from your old system. The AI will extract the data from the image.
- Re-import is safe — If an import didn't go as expected, you can re-run the same step. Duplicate detection prevents double-entry for most data types.
Access Requirements
The Migration portal requires Manager access or above at either the gym level (gym_admin or gym_manager) or the platform level. If you see an "Access Restricted" message, ask your gym admin to grant you the appropriate role.