What You’ll Learn
- How to export child site data for transfer
- How to safely disconnect sites from the current Dashboard
- How to import sites to a new Dashboard
- When to use this process
Prerequisites
- Admin access to both the old and new MainWP Dashboards
- MainWP Child plugin installed and active on all child sites
- New Dashboard already set up and functional
When to Use This Process
Use this process when:| Scenario | Description |
|---|---|
| Replacing Dashboard | Setting up a fresh MainWP installation on a new server |
| Splitting networks | Moving some sites to a separate Dashboard |
| Agency transition | Transferring sites to a client’s own Dashboard |
| Consolidation | Combining sites from multiple Dashboards |
If you’re moving your Dashboard to a new server while keeping the same domain, you may be able to migrate the entire Dashboard instead. See Migrate Dashboard.
Step 1: Export Child Sites
Export your site list from the current Dashboard.The CSV file includes the site connection fields needed for import. Before importing into the new Dashboard, make sure each child site has at least one MainWP Child connection authentication method enabled: Password Authentication, Unique Security ID, or both.
Step 2: Disconnect Sites from Current Dashboard
Break the connection between the old Dashboard and all child sites.
After disconnection:
- The MainWP Child plugin remains active on all child sites
- Child sites are ready to connect to a new Dashboard
- The old Dashboard no longer manages these sites
Step 3: Import Sites to New Dashboard
Add the sites to your new MainWP Dashboard using the exported CSV file.Upload CSV file
Select the CSV file you exported from the old Dashboard. Confirm each row includes the administrator password, Unique Security ID, or both, depending on what is required in that site’s MainWP Child settings.
Troubleshooting
Sites fail to connect after import
| Problem | Solution |
|---|---|
| Connection timeout | Verify child site is accessible and MainWP Child plugin is active |
| Security ID mismatch | The Unique Security ID on the child site may need updating in the import file or site settings |
| Missing connection credential | Add the administrator password, Unique Security ID, or both according to the child site’s MainWP Child settings |
| Firewall blocking | Check that security plugins aren’t blocking the new Dashboard |
Reconnecting individual sites
If a site fails to import:- Visit the child site’s WP Admin directly
- Go to Settings > MainWP Child
- Verify the plugin is active and configured
- Return to the new Dashboard and add the site manually via MainWP > Sites > Add New
Self-Check Checklist
- CSV file exported from old Dashboard
- Sites disconnected from old Dashboard
- CSV file imported to new Dashboard
- All sites show as connected in new Dashboard
- Sync successful for all sites
- Jump to WP Admin works for child sites
Related Resources
- Migrate Dashboard - Move entire Dashboard to new server
- Change Dashboard Domain - Domain change procedures
- Import Sites - Detailed import instructions
- Reconnecting Child Sites - Reconnection process
