Perform a New Migration

Perform a New Migration

Create a fresh configured result when the earlier migrated outcome should not be continued. Select Start a new migration in Connect Stores, then complete Configuration before running.

This guide covers later paid activity. The same dropdown label is also the only action for Demo and a never-run paid migration; those first-run procedures are in Run a Demo or Full Migration.

Decide whether a fresh result is needed

• Use a fresh result when continuing the earlier output would preserve the wrong basis for the intended scope.
• Use Continue with a New Configuration when the earlier result remains useful and supported changes can address the requirement.
• Do not use a fresh action merely to recover an interruption, bypass a Store URL lock, or reset Entity Points usage.

Separate replacement from target clearing

A fresh migration can replace earlier migrated data for the intended scope. Clear data on your Target Store before the Migration is a separate destructive option that can also delete records not created by Next-Cart. Classify protected records and prepare recovery before starting either kind of destructive work.

Before you start

• Open the correct Active purchased migration and confirm remaining capacity for newly eligible counted records.
• Review the previous result in the Target Store admin. Identify records and relationships to retain, correct, or replace.
• Prepare the intended source scope, target protection, and validation samples.
• Do not change connection parameters during active processing. Existing Store URL locks remain in force.

Activity Timeline records actions and operational details; it is not a saved-settings viewer. Inspect exact loaded parameters in Configuration when necessary. Target records establish the previous outcome, not every setting that produced it.

Open the purchased migration

1. In the Next-Cart Dashboard, expand Migrations and open My Migrations.
2. Locate the intended purchased migration, check its platform pair and status, and click Start.

Connect Stores

Use Connect Stores to verify the stored Source and Target details before selecting the migration action.

1. Verify the stored connection details.

   • When both Source and Target URLs are locked, Next-Cart pre-fills the connection parameters from those identities. Check that the URLs are correct; do not re-enter or replace correct values.
   • If only one URL is locked, preserve that identity and check the other side against its intended store. A pre-filled value is not, by itself, proof that its URL is locked.
   • Complete any remaining required values or accepted Source files using Connect Your Source and Target Platforms.

2. Optionally check access.

   • Test Connection is optional, not a prerequisite for the next step.
   • A failure produces a pop-up and Not connected beside the affected platform. Resolve that side using Troubleshoot Connection Setup.
   • Follow Store URL Locking and Store Identity for an identity mismatch. No migration action clears an existing lock.

3. Choose the migration action.

   In the dropdown at the bottom of Connect Stores, select Start a new migration. Next-Cart routes you to Configuration to review the next run.

Configuration

In Configuration, review the available sub-steps in order. Keep settings that remain correct and apply the changes required for this run.

1. Select Data.

   Open Data to review Select Data. The screen shows the data types supported for the active Source-to-Target path.

   • Select each required type, or use Select All when every available type is in scope.
   • Use Clear All only to rebuild the selection. Retain required dependencies and resolve the displayed selection warnings.
   • Click Next to open Additional Options. Use Select Data for data-type and dependency details.

2. Additional Options.

   Review the displayed controls and retain correct settings. Apply only the changes required for this run.

   Additional Option	Action
   Continue the previous migration	Confirm the intended source-processing behavior before enabling this option. Keep it separate from the migration action selected in Connect Stores.
   Clear data on your Target Store before the Migration	Enable only when deleting the selected target data types is intentional and recovery is prepared; otherwise leave it off.
   Strip HTML tags from category and product names	Enable to remove HTML markup from supported Category and Product names.
   Import descriptions images to your Target Store	Enable to copy supported images referenced in descriptions to the Target Store.
   Preserve Customer IDs on your Target Store	Enable to retain supported source Customer IDs after checking for target identifier conflicts.
   Preserve Order IDs on your Target Store	Enable to retain supported source Order IDs after checking for target identifier conflicts.
   Migrate SEO URLs of categories, products, posts and pages	Enable for the supported source URL values required by the migration scope.

   Confirm that any target clearing is approved and that the selected source scope will restore the required data. Resolve uncertain source-reading behavior before enabling it. Click Next to open Attribute Mapping. See Additional Options for detailed behavior and interactions.

3. Attribute Mapping.

   Open Mapping to review Attribute Mapping. Complete the supported groups in their displayed order; the available groups vary by migration path.

   Mapping category	Action
   Site Mapping	Select the target site for each source site.
   Language Mapping	Select the corresponding target language for each required source language.
   Root Category Mapping	Select the target root category for the source catalog.
   Attribute Set Mapping	Select the compatible target attribute set for the source attributes.
   Inventory Location Mapping	Select the target stock location for each source location.
   Customer Group Mapping	Select the corresponding target group for each source Customer Group.
   Order Payment Status Mapping	Select the target payment status with the same intended historical meaning.
   Order Fulfillment Status Mapping	Select the target fulfillment status with the same intended historical meaning.

   Compare each source value with its pre-filled target selection. Keep correct matches, change incorrect matches, and review any Skip selections. Resolve missing target counterparts before continuing. Click Next when another stage follows. See Attribute Mapping for examples and detailed guidance.

4. Add-ons.

   In Add-ons, configure the purchased capabilities supported for the selected path and entities. Complete the applicable groups below.

   • Data Filter: select the entity and click Add Filter. Choose Field, Operator, and the requested Value. Use Add Rule with AND or OR for further conditions, then review the generated Expression. Use the visual builder unless you are experienced with direct expression editing.
   • Data Transformation: select the entity and click Add Rule. Choose Target Field, then Operator, and complete Value as requested by the form. Add further transformation rows with Add Rule.
   • Advanced Data Mapping: select the entity and click Add Mapping. Choose each Source Field and compatible Target Field. Use Add Rule for another field pair.
   • Advanced Database Mapping: verify platform eligibility and schema support. Select the entity, click Add Mapping, and choose Source Field and Target Field. For an approved custom destination, select New Column and enter Custom Target Field. Use Add Rule for another mapping.

   Review the top-to-bottom order of the Add-ons and the rules within each one: Data Filter -> Data Transformation -> Advanced Data Mapping -> Advanced Database Mapping. Complete or remove every unfinished rule and resolve validation errors. Click Next when Custom follows; otherwise complete the final Configuration check below. The Add-on guides contain the detailed examples, input rules, and error explanations.

5. Custom.

   When Custom is part of the purchased configuration, review the requirements included in the active migration and select the options that match the approved scope. Resolve a missing or conflicting requirement before proceeding. Use Custom for the complete procedure.

6. Finish Configuration.

   Review the selected data, enabled options, mappings, Add-on rules, and approved Customization together. Confirm target-data protection and resolve every remaining error using Review Migration Configuration.

   Click Go to Migration to complete Configuration and open Migration.

Before execution, confirm which earlier migrated records can be replaced and which manual, test, or application-created target records must remain. A fresh migration does not automatically authorize clearing every target record.

Migration

1. Review the Migration screen before starting.

   • Check the Source-to-Target summary, selected data types, and any warning about target-data deletion.
   • Read Entity Points Usage as cumulative usage across this purchased migration, not progress through this run.
   • To inspect or change settings before processing, click Edit Config and review the required Configuration steps before execution.

2. Choose Run Mode.

   • Run in Browser: keep this migration tab open. Closing it or navigating away pauses processing.
   • Run in Background: processing continues on Next-Cart servers after the browser closes or the computer is turned off.

3. Click Start Migration and monitor the result.

   • Review Progress, Success, Failed, and Skipped for each data type, then the Total row.
   • Keep store access available. Do not edit connection details or configuration during processing.
   • When processing finishes, use Download Migration Log and record unexplained failures or skips.

Completed means processing finished, not that every record was imported successfully. Use Start and Monitor a Migration for status, interruption, and log guidance.

Validate the fresh result

• Validate every selected data type and required relationship against the fresh-result plan.
• Confirm that only the intended earlier migrated scope was replaced and that any broader clearing matched the separately approved option.
• Verify protected manual and application-created records.
• Investigate failed and skipped records, then complete Validate Results After a Migration Action and the applicable full-result checks.

A fresh action does not reset the purchased path, established Store URL locks, or Entity Points history. Newly eligible counted records consume points on their first successful migration; previously counted records are not counted again solely because their result is replaced.

Resolve a problem

• Replacement scope is unclear: do not start. Classify the affected target records first.
• Configuration needs correction before starting: click Edit Config, review the relevant stages, then click Go to Migration.
• Unexpected deletion or replacement occurred: stop further activity, preserve the log and target evidence, apply the recovery plan where appropriate, and contact Support.

Next Steps

Continue with Validate Results After a Migration Action after the migration activity finishes and the log has been preserved.