When to use Bulk Content Migration
| Scenario | Use Bulk Content Migration |
|---|---|
| New sandbox provisioned, need a copy of Production catalogue | Yes |
| Refreshing a stale Staging environment with current Production data | Yes |
| Standing up a fresh UAT for a major release | Yes |
| Moving one or two products between environments | No, use selective content migration |
| Trying to merge changes without overwriting | No, use selective migration |
The interface
Pick the source environment (store and storefront), pick the destination environment (store and storefront), tick the entities you want to move, and click Start the Migration. Once submitted, switch to the history and rollback tab to monitor progress.
Product Bulk Migration
Product bulk migration processes each product through multiple component steps:- Base product creation (name, description, price, SKU)
- Options and Modifiers setup
- Variants generation
- Images and Videos upload
- Reviews, Custom Fields, and Bulk Pricing Rules
- Complex Rules and Related Products associations
- Channel Assignments and Metafields (product and variant level)
- Content (widgets and template associations)
- Locale (multi-language product data via GraphQL)
Category bulk migration
Category migration automatically includes parent categories, ensuring that the category hierarchy is preserved correctly. This helps eliminate the “parent category not found” errors that are commonly encountered with manual or custom-built BigCommerce category imports.Order Data Migration
Under the Order Data Migration section, enable:- Anonymise Customer Data
Product migration popup, Add or Update mode
When you tick Products on a Bulk migration, a popup appears asking how to handle existing destination data:
The default behaviour, Add/Update Products Data:
- Does not delete any existing products, brands, or categories at the destination.
- Adds missing products from the source.
- Ignores items that already exist with matching SKU and Name.
Entity Dependencies
!!! note- Entities with the black info-circle icon have dependencies.
Example: Migrating Products also migrates Brands and Categories. - Entities without the icon have no dependencies and can be migrated independently.
Monitoring Migration Progress
During bulk migration, you can monitor progress through:- History and Rollback tab for overall migration status
- Monitoring Dashboard for detailed migration metrics and health
Scale plan features
- Schedule Migration, schedule the bulk job for an off-peak window.
- B2B Migration, include B2B Edition entities (companies, addresses, users, quotes, invoices).
To view our Onboarding steps, please access the following article → StagingPro Onboarding