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

Seamlessly Transition Your E-commerce Store from VTEX to CubeCart

Replatforming an e-commerce store is a critical decision for any merchant, promising new opportunities for growth, enhanced control, and improved user experience. If you're considering moving your online business from VTEX to CubeCart, this comprehensive guide will walk you through every essential step. While VTEX, as a highly customizable platform, processes data differently, our approach leverages its data export capabilities via CSV files to ensure a smooth and efficient data transfer to your new CubeCart store. CubeCart, known for its robust features and flexibility, offers a powerful foundation for your future e-commerce endeavors.

This article provides clear, actionable instructions, focusing on data integrity, minimizing downtime, and ensuring a successful transition. Prepare to embark on a journey that will equip you with the knowledge to migrate your valuable store data, including products, customer records, and order history, with confidence.

Prerequisites for a Successful Migration

Before initiating your store migration, careful preparation is key to a smooth process. Ensure both your source (VTEX) and target (CubeCart) environments are ready.

For Your VTEX Store (Source Data Export)

Since VTEX does not offer a direct API connection for standard migration tools in the same way traditional platforms do, the migration process will rely on exporting your store's data into CSV files. This method allows for a comprehensive data transfer, enabling you to bring over essential entities such as:

• Products: Including SKUs, variants, descriptions, images, and pricing.
• Product Categories: The hierarchical structure of your product catalog.
• Manufacturers: Information about your product brands.
• Product Reviews: Valuable customer feedback.
• Customers: Customer records, addresses, and account details.
• Orders: Complete transaction history.
• Invoices: Associated billing information.
• Taxes: Tax rates and rules.
• Coupons: Discount codes and promotions.
• CMS Pages: Static content like 'About Us' or 'Contact Us' pages.

Ensure that your CSV exports are clean, well-organized, and contain all necessary fields for accurate import into CubeCart. For more details on preparing your source, consult our guide on preparing your source store for migration.

For Your CubeCart Store (Target)

To prepare your CubeCart store for the incoming data, you will need the following:

• A Fresh CubeCart Installation: It is highly recommended to have a clean, empty CubeCart installation. This minimizes conflicts and ensures that the migrated data is accurately placed without existing redundancies.
• Full Administrative Access: You will need the admin login, admin password, and the administrative URL (adminLogin, adminPwd, adminUrl) for your CubeCart store. This allows the migration tool to establish the necessary connection and write permissions. For a detailed guide on access credentials, refer to The Short & Essential Guide to Access Credentials.
• Bridge Installation: CubeCart migrations typically use a 'Bridge' connection method. This involves uploading specific files to the root folder of your CubeCart installation via FTP. These files create a secure connection between your migration tool and your CubeCart database. You will need to provide the url and bridgeLocation. Learn more about what a root folder is and how to find it.
• Plugin Requirement: A specific Cart2Cart CubeCart Migration module is required for the connection to be established successfully. Ensure this module is installed on your CubeCart store.
• Hosting Resources: Verify that your hosting environment for CubeCart has sufficient resources (disk space, memory, processing power) to accommodate your current and future store data, as well as handle the migration process efficiently.

For additional information on preparing your target store, please see our FAQ on how to prepare your target store.

Performing the Migration: A Step-by-Step Guide

The migration process is streamlined through a user-friendly wizard. Follow these steps carefully to ensure a successful data transfer from your VTEX CSV files to CubeCart.

Step 1: Initiate Your Migration Process

Begin by navigating to the migration wizard interface. This is where you'll start configuring your move from VTEX to CubeCart. You can choose to start a do-it-yourself migration or explore our assisted migration services.

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

In this crucial step, you will specify your source platform. Select "CSV File to Cart" from the dropdown menu, representing your exported VTEX data. You will then be prompted to upload your prepared CSV files containing all your e-commerce entities. This 'file only' connection method ensures your VTEX data is securely uploaded for processing.

Step 3: Set Up Your CubeCart Target Store

Next, choose "CubeCart" as your target shopping cart. You will then need to provide the necessary access credentials:

• Admin Login
• Admin Password
• Admin URL
• Store URL
• Bridge Location (after uploading the bridge files to your CubeCart's root directory)

Remember that the Cart2Cart CubeCart Migration module is required for this connection to be established. Ensure all these details are accurate for a seamless connection.

Step 4: Choose Data Entities for Transfer

This stage allows you to precisely select which types of data you wish to migrate from your VTEX CSV files to your new CubeCart store. You can choose to transfer:

• Products (including images in descriptions)
• Product Categories
• Manufacturers
• Product Reviews
• Customers (with password migration options)
• Orders
• Invoices
• Taxes
• Coupons
• CMS Pages

You can select all entities or pick them individually based on your specific requirements. The system will display the count of each entity detected in your uploaded CSV files.

Step 5: Select Additional Migration Options

Enhance your data transfer with a range of additional options designed to optimize your new CubeCart store:

• Clear Target Store Data: This option will delete all existing data in your CubeCart store before the migration, ensuring a clean import. Read more about clearing target data.
• Preserve Product IDs, Orders IDs, Customers IDs: Crucial for maintaining internal records and integrations, these options ensure the original IDs are carried over. Learn how preserving IDs works.
• Migrate Images in Description: Ensure all product images embedded within descriptions are transferred.
• Password Migration: Migrate customer passwords securely, allowing returning customers to log in without needing to reset.
• SEO URLs & 301 SEO URLs: Essential for preserving your search engine rankings and link equity, these options create friendly URLs and implement 301 redirects from your old VTEX URLs to your new CubeCart ones.
• Create 301 SEO URLs: Specifically focuses on setting up permanent redirects to guide search engines and users to the new location of your content.
• Skip Custom Attributes: An option to exclude custom product attributes if they are not needed in CubeCart.

Carefully consider which of these options align with your strategic goals for the CubeCart platform.

Step 6: Configure Data Mapping

The data mapping step is vital for ensuring consistency between your VTEX data structure and CubeCart's. Here, you will match customer groups and order statuses from your source CSV files to their corresponding equivalents in CubeCart. This ensures that customer segmentation and order processing workflows remain intact and functional on your new platform.

Step 7: Launch Your Demo or Full Migration

Before committing to the full migration, we highly recommend running a free demo migration. This allows you to transfer a limited number of entities (e.g., 10-15 products, customers, orders) to your CubeCart store. Review the results to verify data accuracy, appearance, and functionality. Once satisfied, you can proceed to launch the full migration.

For added peace of mind, consider selecting a Migration Insurance Plan. This service provides a set number of re-migrations, offering flexibility in case you need to fine-tune your data after the initial transfer. Learn more about how Migration Insurance works.

Post-Migration Steps

Once your data has been successfully transferred to CubeCart, a few crucial post-migration tasks remain to ensure your new store is fully operational and optimized.

1. Thorough Testing

This is arguably the most important step. Dedicate time to rigorously test every aspect of your new CubeCart store:

• Products: Check product pages, images, descriptions, pricing, SKUs, and variants. Ensure all data points have migrated correctly.
• Customers: Verify customer accounts, login functionality (especially if passwords were migrated), and address books.
• Orders: Review a sample of historical orders to ensure details, statuses, and associated customer data are accurate.
• Checkout Process: Perform test purchases using various payment and shipping methods.
• Site Search: Test search functionality to ensure products and content are discoverable.
• Internal Links: Click through various links to ensure they lead to the correct pages.
• Forms: Test contact forms, newsletter sign-ups, and other interactive elements.

2. Update DNS Records

After thorough testing, it's time to point your domain name to your new CubeCart store. Update your DNS (Domain Name System) records with your domain registrar. Be prepared for a brief period of downtime during DNS propagation, which can take a few hours to 48 hours. Plan this step during off-peak hours to minimize impact on your customers.

3. Implement 301 Redirects

If you opted to generate 301 redirects during the migration, verify their functionality. If not, manually set up 301 redirects from your old VTEX URLs to their corresponding new CubeCart URLs. This is crucial for preserving your SEO rankings, maintaining link equity, and ensuring a seamless user experience, preventing '404 Not Found' errors for your visitors and search engine crawlers.

4. Review and Install Themes & Extensions

Now is the time to customize your CubeCart store's appearance and extend its functionality. Explore CubeCart's theme store for a new design, and install any necessary extensions for features like marketing, analytics, or advanced shipping calculations. Ensure all chosen themes and extensions are compatible with your CubeCart version.

5. Update Analytics & Integrations

Reconnect all third-party services and tools. This includes:

• Google Analytics / Other Tracking Tools: Update tracking codes to monitor your new store's performance.
• Payment Gateways: Configure and test your preferred payment processors.
• Shipping Solutions: Integrate and test your shipping carriers and their APIs.
• Marketing Automation: Reconnect email marketing platforms, CRM systems, and other marketing tools.

6. Notify Customers

Inform your customers about the successful migration. A brief email or an announcement on your social media channels can help manage expectations and introduce them to your new and improved online store experience.

7. Ongoing Monitoring

For the first few weeks post-migration, closely monitor your CubeCart store's performance. Keep an eye on website speed, error logs, user behavior, and conversion rates. Address any issues promptly to ensure your new platform delivers the best possible experience.

By following these meticulous steps, you can confidently transition your e-commerce business from VTEX to CubeCart, paving the way for renewed growth and enhanced operational efficiency. If you encounter any challenges, remember that expert assistance is always available via Contact Us.