CommerceTools to Ecwid Migration - Step-by-Step Guide & Expert Services

A Comprehensive Guide to Transitioning from CommerceTools to Ecwid

As your e-commerce business evolves, so do your platform needs. Many merchants, after leveraging the extensive customization and enterprise-grade features of CommerceTools, seek a more streamlined, embedded, or simpler solution like Ecwid. Ecwid is renowned for its ease of use, ability to integrate into existing websites, and cost-effectiveness, making it an attractive option for businesses looking for flexibility without sacrificing core functionality.

This guide provides a clear, step-by-step approach to seamlessly replatform your online store from CommerceTools to Ecwid. Given CommerceTools' headless nature and the lack of a direct API connector for migration tools, the most efficient and recommended method for data transfer will involve exporting your CommerceTools data into structured CSV files, which will then be imported into the migration wizard for transfer to Ecwid.

Prerequisites for a Smooth Migration

Before embarking on your data transfer journey, it's crucial to prepare both your source CommerceTools store and your target Ecwid store. Proper preparation minimizes potential issues and ensures data integrity throughout the transition.

• For Your CommerceTools (Source) Store:
  • Access to Admin Panel: Ensure you have full administrative access to your CommerceTools project to export all necessary data.
  • Data Export: Prepare to export your critical store data (products, categories, customers, orders, reviews, CMS pages, blog posts, coupons, etc.) into well-structured CSV files. This will be the primary method for retrieving your CommerceTools information.
  • Data Audit: Conduct a thorough audit of your CommerceTools data. Clean up any outdated products, redundant customer entries, or inconsistent information. Migrating clean data to your new Ecwid store is vital.
  • Backup Your Data: Always create a complete backup of your CommerceTools data before initiating any migration process.
• For Your Ecwid (Target) Store:
  • Active Ecwid Account: Ensure you have an active Ecwid account set up and ready to receive your store data.
  • Install Cart2Cart Ecwid Migration App: To facilitate the API connection, you will need to install the Cart2Cart Ecwid Migration App within your Ecwid store's control panel.
  • API Credentials: You will need to obtain the necessary API credentials (such as your Store ID and Access Token). These are typically found in your Ecwid admin panel, often under 'Settings' > 'API' or 'Apps'. Ensure you have the correct API scopes enabled for read/write access to all relevant data entities. Ecwid requires an HTTPS connection for API access.
  • Understand Limitations: Be aware of Ecwid's API rate limits, which might affect the speed of large data transfers.
• General Preparations:
  • Plan for Downtime: While the migration tool works in the background, plan for minimal downtime, especially during the final data synchronization.
  • Review FAQs: Consult our How to prepare Source store for migration? and How to prepare Target store for migration? for additional guidance.

Performing the Migration: A Step-by-Step Guide

Follow these detailed steps to execute your CommerceTools to Ecwid data transfer using a migration wizard.

Step 1: Get Started with the Migration Wizard

Begin your migration journey by accessing the migration wizard. You'll typically find an option to start a 'Do-It-Yourself Migration' or similar on the service's homepage. This initiates the guided process.

Step 2: Configure Your Source Store (CommerceTools via CSV)

This critical step involves telling the migration tool where your existing store data resides.

1. Select Source Cart: From the list of supported platforms, choose "CSV File to Cart" as your source shopping cart. This option is used when migrating from platforms like CommerceTools that require data export into CSV files.
2. Upload CSV Files: The wizard will prompt you to upload the CSV files you exported from your CommerceTools project. Ensure you upload all relevant files containing your products, product categories, product manufacturers, product reviews, customers, orders, invoices, taxes, stores, coupons, CMS pages, blogs, and blog posts. For more details on this process, refer to our CSV.File Data Migration service.

Step 3: Set Up Your Target Store (Ecwid)

Now, connect the migration tool to your Ecwid store, where your data will be transferred.

1. Select Target Cart: Choose "Ecwid" from the dropdown list of target shopping carts.
2. Install Ecwid Migration App: The wizard will remind you to install the 'Cart2Cart Ecwid Migration App' in your Ecwid store if you haven't already. This app is essential for establishing a secure API connection.
3. Provide API Credentials: Enter your Ecwid Store ID and Access Token into the required fields. Instructions on how to find these credentials are usually provided within the wizard or you can consult The Short & Essential Guide to Access Credentials for Cart2Cart. These details grant the migration tool permission to access and transfer data to your Ecwid store.

Step 4: Select Data Entities for Transfer

This step allows you to specify exactly which types of data you want to move from your CommerceTools CSV files to Ecwid.

You can choose to migrate all available entities or selectively pick what you need. Ecwid typically supports the migration of:

• Products (including SKUs, variants, descriptions, images, prices)
• Product Categories
• Product Reviews
• Customers (including customer data)
• Orders (including order history and statuses)
• CMS Pages
• Gift Cards
• Coupons
• Blog Posts

Review the list and tick the checkboxes next to the data types you wish to transfer to your new Ecwid store.

Step 5: Configure Additional Migration Options

Enhance your migration with a range of optional features designed to optimize data transfer and SEO.

Consider these valuable options:

• Clear Target Store Data: The Clear current data on Target store before migration option removes any existing data in your Ecwid store before the migration, ensuring a clean slate.
• Preserve IDs: Options like "Preserve Order IDs" help maintain the original IDs for your orders, categories, and products, which can be beneficial for record-keeping and existing integrations. Learn more about How Preserve IDs options can be used?.
• SEO URLs & 301 Redirects: Selecting "SEO URLs" and "Create 301 SEO URLs" is crucial for maintaining your search engine rankings and link equity. This ensures that old URLs redirect seamlessly to their new counterparts on Ecwid.
• Migrate Images in Description: Transfers product images embedded within descriptions.
• Migrate Groups to Tags: Converts customer groups from your source data into tags within Ecwid.
• Concat Short Description: Combines short descriptions with full descriptions if Ecwid only supports one.

Carefully select the options that align with your business needs and data structure.

Step 6: Map Data Fields

This step is crucial for ensuring that your source data maps correctly to Ecwid's structure. You'll typically need to map:

• Customer Groups: Match customer groups from your CommerceTools data (e.g., 'Wholesale', 'Retail') to corresponding customer groups or tags in Ecwid.
• Order Statuses: Map the various order statuses (e.g., 'Pending', 'Processing', 'Completed', 'Refunded') from your CommerceTools data to their equivalents in Ecwid.

Accurate data mapping is essential for maintaining data consistency and a seamless user experience in your new store.

Step 7: Launch Your Migration

With all configurations set, you're ready to initiate the data transfer.

1. Free Demo Migration: It's highly recommended to run a free demo migration first. This transfers a limited number of entities, allowing you to review the results and ensure everything is mapping correctly before committing to the full transfer.
2. Full Migration: Once satisfied with the demo, proceed with the full migration. This will transfer all selected data from your CommerceTools CSV files to your Ecwid store.
3. Migration Insurance: Consider adding Migration Insurance Service. This valuable add-on provides a set number of re-migrations within a specific period, offering peace of mind in case any adjustments or additional transfers are needed. Learn more about How Migration Insurance works?.

Post-Migration Steps

After your data has successfully moved from CommerceTools to Ecwid, a few critical steps remain to ensure your new store is fully operational and optimized.

1. Thorough Data Verification: This is paramount. Log into your Ecwid admin panel and meticulously check that all essential data has been transferred accurately:
   • Products: Verify product details, SKUs, pricing, images, variants, and stock levels.
   • Categories: Ensure product categories are correctly structured and linked.
   • Customers: Check customer accounts, historical order data, and contact information.
   • Orders: Review order history, statuses, and all transaction details.
   • Other Entities: Confirm the migration of reviews, coupons, CMS pages, and blog posts.
2. Functionality Testing: Test every aspect of your new Ecwid store as a customer would:
   • Navigate through products and categories.
   • Add items to the cart and complete the checkout process.
   • Test customer login, registration, and account management.
   • Verify search functionality.
   • Submit contact forms.
3. Configure Shipping & Taxes: Set up your shipping zones, methods, and rates within Ecwid. Configure your tax settings to ensure compliance with local regulations.
4. Design and Layout Customization: Customize your Ecwid store's appearance to match your brand. Adjust themes, colors, fonts, and ensure your storefront provides an excellent user experience.
5. Update SEO and Redirects: If you used the 301 redirect option during migration, double-check that all critical old URLs from CommerceTools successfully redirect to their new Ecwid counterparts. Update your sitemap in Google Search Console and notify search engines of the change to preserve your SEO rankings and link equity.
6. Remove Old Store: Once you are completely confident in your new Ecwid store, you can safely decommission your CommerceTools project.
7. Monitor Performance: Keep a close eye on your Ecwid store's performance, sales, and user engagement in the weeks following the migration.

Migrating an e-commerce store can be complex, but with careful planning and the right tools, your transition from CommerceTools to Ecwid can be a resounding success. Should you encounter any challenges or require expert assistance, don't hesitate to Contact Us for support.