TomatoCart to CubeCart Migration - Step-by-Step Guide & Expert Services

Migrating from TomatoCart to CubeCart: A Comprehensive How-To Guide

As your e-commerce business evolves, replatforming to a more robust or feature-rich solution like CubeCart can be a strategic move. While TomatoCart served its purpose, transitioning to a new platform offers opportunities for enhanced performance, scalability, and an improved user experience. This guide will walk you through the entire process of moving your valuable store data from TomatoCart to CubeCart, ensuring a smooth and secure data transfer.

Given that TomatoCart is an older platform, the most reliable and efficient method for data extraction is typically via CSV file export. We’ll leverage this method to seamlessly transfer your product data, customer information, orders, and more into your new CubeCart store using a specialized migration service.

Prerequisites for Migration

Before initiating your migration, a few preparatory steps are essential to ensure a successful data transfer and minimize potential downtime:

• TomatoCart Data Export: Since direct API connections for TomatoCart are often unavailable, you'll need to export all your vital store data into structured CSV files. This includes:
  • Products (SKUs, descriptions, images, variants, prices, quantities)
  • Product Categories
  • Customer records (names, addresses, order history)
  • Orders (status, items, shipping info)
  • Manufacturers
  • Product Reviews
  • Invoices
  • Coupons
  • CMS Pages
  • Blogs and Blog Posts (note: CubeCart does not natively list support for Blogs, so plan accordingly for this data)
  Ensure your CSV files are clean, well-organized, and contain all necessary fields for mapping to CubeCart. For more details on preparing your source store, read our guide on how to prepare your Source store for migration.
• CubeCart Store Setup: Have a fresh installation of CubeCart (versions 3.0.0 through 4.2.0 are supported) ready on your hosting environment. Familiarize yourself with its admin panel.
• Bridge Connector Plugin: CubeCart migrations require the installation of the Cart2Cart CubeCart Migration module. This plugin facilitates the secure data exchange between your migration service and your CubeCart store.
• Admin Access Credentials: You’ll need full administrator login details for your CubeCart store (adminLogin, adminPwd, adminUrl).
• FTP Access: FTP/SFTP access to your CubeCart root folder is required to upload the necessary connection bridge files securely. Understand what a root folder is and where to find it.
• Data Backup: Always create a complete backup of both your TomatoCart data (if possible) and your new CubeCart store before starting any migration process. This safeguards your information against any unforeseen issues.
• Review Target Store Preparation: Consult our guide on preparing your Target store for migration to ensure all settings are optimized.

Performing the Migration: A Step-by-Step Guide

Transferring your e-commerce data from TomatoCart (via CSV) to CubeCart can be streamlined using an automated migration service. Follow these steps for a hassle-free transition:

Step 1: Get Started with Your Migration

Navigate to the migration service platform. You will typically start by initiating a new migration process.

Step 2: Connect Your Source Store (TomatoCart via CSV)

This is where you'll tell the system where your current store's data is coming from. Since TomatoCart is not directly integrated, you will select the 'CSV File to Cart' option as your source.

• From the dropdown list, choose 'CSV File to Cart' as your Source Cart.
• Upload the CSV files you exported from your TomatoCart store. Ensure all relevant entities like products, customers, and orders are included.

For more detailed information on preparing and uploading your CSV files, refer to our CSV.File Data Migration service page.

Step 3: Configure Your Target Store (CubeCart)

Next, you’ll connect your new CubeCart store to the migration service.

• Select 'CubeCart' as your Target Cart.
• Enter your CubeCart store’s URL.
• Install the Cart2Cart CubeCart Migration module on your CubeCart installation. This involves uploading a 'bridge' file via FTP to your CubeCart root directory and following the plugin's installation instructions. This bridge acts as a secure conduit for data transfer.
• Provide your CubeCart admin panel login credentials (adminLogin, adminPwd) to establish the connection.

The system will then validate the connection, ensuring it can communicate effectively with your CubeCart store.

Step 4: Select Data Entities to Migrate

This crucial step allows you to choose exactly which data types you wish to transfer from your TomatoCart CSV files to your new CubeCart store.

You can select individual entities or opt to migrate all available data. CubeCart supports the migration of:

• Products, including product attributes and variants (if specified in CSV)
• Product Categories
• Product Manufacturers
• Product Reviews
• Customers and their customer groups
• Orders
• Invoices
• Taxes
• Stores
• Coupons
• CMS Pages

Important Note: While your TomatoCart CSV might include blog data, CubeCart's native support for blogs is not listed. You may need to consider alternative solutions for migrating blog posts and content after the main data transfer.

Step 5: Choose Additional Migration Options

Enhance your data transfer with various additional options tailored for CubeCart. These settings help preserve critical store data and SEO rankings.

Commonly selected options for CubeCart include:

• Clear Target Store Data: Optionally clear all existing data on your CubeCart store before migration to ensure a clean slate.
• Preserve IDs: Maintain original Product IDs, Order IDs, and Customer IDs to ensure consistency and avoid conflicts. Learn more about how Preserve IDs options can be used.
• Migrate Images in Product Descriptions: Transfer product images embedded within descriptions.
• Password Migration: Migrate customer passwords, allowing your existing customers to log in to the new CubeCart store with their old credentials.
• SEO URLs & Create 301 SEO URLs: Crucial for maintaining your search engine rankings and link equity. This option automatically generates 301 redirects from your old TomatoCart URLs to the new CubeCart URLs, preventing broken links.
• Migrate Invoices: Ensure all historical invoice data is moved.
• Skip Custom Attributes: If your CubeCart setup doesn't require all custom product attributes, you can choose to skip them.

Step 6: Map Data Fields (Customer Groups & Order Statuses)

Data mapping is vital for ensuring consistency between your old and new stores. You'll need to match customer groups and order statuses from your TomatoCart CSV data to their corresponding equivalents in CubeCart.

For instance, map 'Pending Payment' in TomatoCart to 'Awaiting Payment' in CubeCart, or 'Wholesale Customer' to a similar customer group in your new store. This step ensures data integrity and operational continuity.

Step 7: Perform Demo Migration & Launch Full Transfer

Before committing to the full migration, it's highly recommended to perform a free demo migration. This transfers a limited number of entities (e.g., 10-20 products, customers, and orders) to your CubeCart store, allowing you to:

• Preview the data transfer and check for accuracy.
• Ensure all chosen options work as expected.
• Verify data integrity and visual appearance.

Once you are satisfied with the demo results, proceed to the full migration. You will see a summary of all selected entities and the total cost. You may also consider adding Migration Insurance for additional peace of mind and access to re-migrations.

The full data transfer will begin, and you will be notified upon completion. The duration depends on the volume of your data.

Post-Migration Steps

After your data has successfully been transferred to CubeCart, there are several crucial steps to finalize your store and ensure a seamless launch:

• Thorough Testing: Conduct extensive testing of your new CubeCart store. Verify:
  • Product pages (images, descriptions, pricing, variants)
  • Checkout process (from adding to cart to order confirmation)
  • Customer accounts (login, order history, address books)
  • Search functionality
  • Payment gateways and shipping methods
  • All links and redirects
• Update DNS Records: Once you're confident everything is working, update your domain's DNS settings to point to your new CubeCart store. Plan this during off-peak hours to minimize impact.
• Configure Store Settings: Reconfigure any specific settings in CubeCart that weren't part of the data migration, such as taxes, shipping zones, payment gateways, and store policies.
• Install Essential Extensions: Integrate any necessary CubeCart modules or plugins that enhance functionality (e.g., marketing tools, analytics, advanced SEO).
• Implement 301 Redirects: While the migration service handles many 301 redirects, review your old TomatoCart URLs and ensure all critical pages redirect correctly to their new CubeCart counterparts. This is vital for maintaining SEO rankings and link equity.
• Update Internal Links & Sitemap: Ensure all internal links within your CubeCart store point correctly, and submit your new sitemap to search engines.
• Monitor SEO Performance: Keep a close eye on your search engine rankings and traffic post-migration using tools like Google Analytics and Google Search Console.
• Inform Your Customers: If there were significant URL changes or a period of downtime, notify your customers about the new store and any changes to their login experience.
• Consider Recent Data Migration: If new orders or customer registrations occurred on your TomatoCart store during or immediately after the initial migration, consider a Recent Data Migration Service to transfer this new data.

By following these steps, you can confidently transition your e-commerce business from TomatoCart to CubeCart, setting the stage for future growth and success. If you encounter any challenges or require assistance, don't hesitate to contact our support team for expert guidance.