OpenCart to WooCommerce Migration Guide

OpenCart product options do not become WooCommerce product add-ons by default.

They become variants instead, a real structural difference that changes how customers select and how you manage inventory for those options.

Getting this wrong, or not knowing it happens at all, is the single most common surprise in this specific migration.

Both platforms are self-hosted and open, which gives you more direct access to your own data than a closed platform ever would, but it also means the responsibility for getting the mapping right sits completely with you.

This guide covers the real attribute mapping issue, customer account migration, URL redirects, and every step in order.

Key Takeaways

• There is no default way OpenCart product options become WooCommerce variants. The outcome depends completely on your migration tool, some map compatible options to variations automatically, others ignore unsupported types, and custom option types like engraving or gift wrap commonly need a Product Add-Ons plugin or manual configuration, not a mandatory prerequisite.
• OpenCart has no native product CSV exporter through System, Backup/Restore. That tool backs up database tables, it does not produce a usable product CSV. A dedicated export extension or migration tool is required for that.
• OpenCart has no native customer or order export either. Both require a database export, an export extension, or a migration tool.
• Manual CSV migration and using a dedicated migration tool are separate workflows with different real steps, this guide covers both completely and separately.
• Whether product images migrate automatically depends on your method. Most dedicated migration tools handle image transfer as part of the process. Manual downloading and re-uploading is a manual-migration-specific step, not a universal requirement.

How Product Options Actually Map, and Why It Depends on Your Tool

This is worth understanding before choosing a migration method, since it shapes what to expect afterward.

• WooCommerce has no native OpenCart importer, so there is no single default conversion behavior for product options at all
• Many migration tools map compatible OpenCart options to WooCommerce variations automatically, but support varies by tool and by option type
• Custom option types, a gift wrap checkbox, an engraving text field, that function more like add-ons than true variations commonly need additional configuration
• A Product Add-Ons plugin is one real solution for preserving true add-on behavior, not a mandatory step required by every migration path, some store owners recreate these manually after the core migration instead, and some migration tools handle a portion of this natively

Choosing Your Migration Method

This is the real fork point, and picking one path clearly avoids the confusion of mixing steps meant for a different method.

	Manual CSV Migration	Migration Tool (LitExtension, Cart2Cart, or a dedicated plugin)
Best for	Small catalogs, comfortable with database exports and manual CSV work	Most real migrations, larger or more complex catalogs
Product export	Requires a dedicated export extension or direct database export, not OpenCart’s Backup/Restore tool	The tool connects directly and handles export as part of its process
Customer and order export	Requires a database export, export extension, or migration tool, OpenCart has no native path	Handled by the tool directly in most cases
Images	Downloaded and re-uploaded manually	Commonly migrated automatically as part of the tool’s process, confirm this directly with your specific tool
Same-server hosting requirement	Not applicable	Varies by tool specifically, the official WooCommerce OpenCart Migration plugin requires both databases on the same server, while FG OpenCart to WooCommerce can work across servers by importing an SQL dump, and cloud services like LitExtension and Cart2Cart do not require same-server hosting at all

Pick one path and follow it through completely.

A Real Hosting Constraint, Scoped Correctly

The same-server database requirement is specific to certain tools, not a general rule for this migration. The official WooCommerce OpenCart Migration plugin does require both your OpenCart and WordPress databases on the same server.

Other real options do not share this constraint, FG OpenCart to WooCommerce can work across separate servers by importing an SQL dump into the WordPress database, and cloud-based services like LitExtension and Cart2Cart connect to your stores directly without a same-server requirement at all. Confirm this against your specific chosen tool, not against migration in general.

Choosing Your Hosting

Confirm your migration tool’s actual requirements first, since this affects what your hosting setup needs to support.

1. Confirm your chosen migration tool’s specific hosting requirements, including the same-server question above
2. Select hosting that meets those requirements
3. Install WordPress and WooCommerce only after hosting is confirmed and provisioned

The Pre-Migration Checklist

1. Decide your migration method
   • Manual CSV or a dedicated migration tool, based on your catalog size and technical comfort
2. Confirm your export approach for products
   • A dedicated export extension, a direct database export, or your chosen migration tool, not OpenCart’s Backup/Restore feature
3. Confirm your export approach for customers and orders
   • Database export, export extension, or migration tool, OpenCart provides no native path for either
4. Decide how to handle product options
   • Based on the guidance above, whether a Product Add-Ons plugin, manual recreation, or your migration tool’s native handling fits your actual catalog
5. Document your current URL structure
   • Crawl your live OpenCart site or export a sitemap, this becomes the source for your redirect map later

Step-by-Step Migration

Step 1: Confirm Hosting Meets Your Method’s Requirements (Planning)

1. Confirm your chosen migration method’s specific requirements, including any same-server database constraint
2. Adjust or select hosting accordingly before installing anything

Step 2: Install WordPress and WooCommerce (WooCommerce)

1. Install WordPress on your confirmed hosting
2. Install and activate WooCommerce
3. Complete the initial setup wizard, store location, currency, and basic configuration

Method A: Manual CSV Migration

Follow this path completely if you chose manual migration. Do not mix in migration-tool steps from Method B.

A1: Export Your Products (OpenCart)

1. Use a dedicated export extension from the OpenCart marketplace, or perform a direct database export, OpenCart’s built-in Backup/Restore tool backs up database tables and is not a product CSV exporter
2. Confirm the resulting export includes names, descriptions, prices, images, and attribute or option data

A2: Export Your Customers and Orders (OpenCart)

1. Use a database export or a dedicated export extension, OpenCart has no native customer or order CSV export
2. Export customer and order data separately, confirming both are captured completely

A3: Format Your CSV Files (Planning)

This step involves real mapping work, not just renaming columns.

1. Rename columns to match WooCommerce’s expected structure
2. Map attributes and categories to their WooCommerce equivalents
3. Map images, confirming URLs are accessible or files are prepared for direct upload
4. Handle parent-child product relationships, OpenCart and WooCommerce structure variant relationships differently
5. Map product options according to the decision made in your pre-migration checklist
6. Confirm tax class mapping is correct before importing

A4: Import Your Products (WooCommerce)

1. Go to Products, then Import
2. Upload your formatted product CSV
3. Review the import results against your original OpenCart product count

A5: Import Your Customers and Orders (WooCommerce)

1. Install a customer import plugin, such as Import and Export Users and Customers
2. Install an order import plugin, such as Order Import Export for WooCommerce
3. Import both data sets, verifying customer references match correctly on orders to avoid broken order history links

A6: Download and Re-Host Your Images (WooCommerce)

Manual migration requires this step directly, since no automated tool is handling image transfer in this path.

1. Download all product images referenced by your OpenCart export
2. Upload them into WooCommerce’s media library
3. Confirm images display correctly on live product pages after re-hosting

Method B: Migration Tool Workflow

Follow this path completely if you chose a dedicated migration tool. Do not mix in manual CSV steps from Method A.

B1: Prepare Your WooCommerce Environment (WooCommerce)

1. Confirm WordPress and WooCommerce are installed and basic configuration is complete
2. Note your tool’s specific documentation on product option handling, since this varies by tool

B2: Configure and Run the Migration Tool (Migration Tool)

1. Set up your chosen tool, LitExtension, Cart2Cart, or a dedicated plugin, connecting it to both your OpenCart source and WooCommerce destination
2. Select which entities to migrate, products, customers, orders, and confirm directly whether images, CMS pages, and reviews are covered by your specific tool
3. Run a demo migration first if the tool supports it, reviewing results before committing to a full run
4. Execute the full migration once results check out

B3: Verify the Results (Both Platforms)

1. Cross-check migrated product, customer, and order counts against your original OpenCart numbers
2. Confirm images migrated correctly, most tools handle this automatically, but verify a real sample directly rather than assuming
3. Verify product options mapped as expected based on your tool’s documented behavior

Both Methods Converge Here

Verify Password Migration If Applicable

Some tools, including LitExtension’s OpenCart plugin, document password migration support, since both platforms are self-hosted with accessible databases. This is worth testing directly rather than assuming it worked for every account, regardless of which tool you use.

1. If your tool claims password migration support, test this with a real account login
2. Have a password reset communication ready regardless, as a fallback for any accounts where it did not transfer cleanly

Recreate Pages Not Covered by Your Migration Method

Whether pages like About Us and Contact Us migrate automatically depends completely on your specific tool or method, some commercial migration services do support CMS page migration, others do not.

1. Confirm directly whether your chosen method covers CMS pages
2. For anything not covered, copy the content manually into WordPress’s editor
3. Recreate your navigation menu under Appearance, then Menus, matching your original site structure

Set Up Your Redirect Map

1. Using the URL structure you documented in the pre-migration checklist, map every OpenCart URL to its new WooCommerce equivalent
2. Set up 301 redirects for every mapped URL through a WordPress redirect plugin
3. Test a representative sample of redirects directly before considering this step complete

Test Everything Before Launch

1. Place a real test order, confirming payment processing and order confirmation
2. Verify products using any Product Add-Ons plugin or custom option handling display and function correctly
3. Confirm redirects, recreated pages, and navigation menus all work as expected

Go Live

1. Update your domain’s DNS to point to your WooCommerce hosting
2. Keep your OpenCart environment accessible for a defined rollback window
3. Monitor Google Search Console closely for the first two to four weeks, since an incorrect URL structure is a common cause of lost rankings in this specific migration

FAQ for OpenCart to WooCommerce Migration