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

A Comprehensive Guide to Transitioning from VTEX to BigCommerce

Replatforming your e-commerce store is a strategic decision that can unlock new growth opportunities and enhance your operational efficiency. If you're considering moving your online business from VTEX to BigCommerce, this detailed guide will walk you through every essential step. While VTEX does not support direct API connections for migration tools, we will leverage a robust CSV-based data transfer method to ensure a smooth transition of your valuable store data to BigCommerce.

BigCommerce offers a powerful, scalable platform with extensive customization options, making it an excellent choice for merchants looking to expand their digital footprint. This guide is designed to provide clear, actionable insights for a successful data migration, helping you preserve critical information like products, customer data, and order history, while setting up your new store for future success.

Prerequisites for Migration

Before you embark on your store migration journey, adequate preparation is key to a seamless transition and to maintaining data integrity. Here's what you need to have in place for both your VTEX source store and your BigCommerce target store.

Preparing Your VTEX Source Store (via CSV Export)

Since direct API connection from VTEX is not supported, the migration will rely on exporting your data into CSV files. This method, often referred to as CSV.File Data Migration, requires careful attention to detail.

• Data Export: You will need to export all relevant data from your VTEX store into organized CSV files. This includes essential entities such as products (with SKUs, variants, images, descriptions), product categories, customer records, order history, coupons, and any CMS pages or blog posts. Ensure that all data is current and accurate before export.
• Data Cleaning: Use this opportunity to clean up any redundant, outdated, or incorrect data. A clean dataset will result in a more efficient migration and a more organized new store.
• Image URLs: If you intend to migrate images embedded in product descriptions or other content, ensure that their URLs are accessible or included correctly within your CSV files for proper re-linking on BigCommerce.
• Backup Your Data: Always perform a complete backup of your VTEX store data before initiating any export processes. This safeguards your information in case of unforeseen issues.

For more general guidance on preparing your source store, refer to our How to prepare Source store for migration? FAQ.

Preparing Your BigCommerce Target Store (API Connection)

Your BigCommerce store will be the destination for all your migrated data. Ensure it's ready to receive information via API.

• Set Up Your BigCommerce Store: Create a new BigCommerce store or ensure your existing one is accessible. No need to populate it with data, as the migration process will handle that.
• Generate API Credentials: BigCommerce relies on API access for data transfer. You'll need to generate specific credentials:
  • Client ID (Username): A unique identifier for your API access.
  • Access Token (API Token): The secure key that authorizes access to your store's data.
  • API Path: The specific URL endpoint for your BigCommerce store's API.

  You can generate these credentials within your BigCommerce admin panel by navigating to Advanced Settings > API Accounts. Create a new API account and ensure it has the necessary scopes (read/write permissions) for all the data entities you plan to migrate (e.g., Products, Customers, Orders, Categories). BigCommerce requires a custom app development approach for API access, which is handled by the migration connector.

• HTTPS Requirement: Your BigCommerce store must use HTTPS for secure API communication. This is standard for BigCommerce stores.

For detailed instructions on setting up your target store and generating API credentials, consult our guides: How to prepare Target store for migration? and The Short & Essential Guide to Access Credentials for Cart2Cart.

Performing the Migration: A Step-by-Step Guide

Once your preparations are complete, you can begin the migration process using a specialized migration wizard. Follow these steps carefully to ensure a successful data transfer from VTEX (via CSV) to BigCommerce.

Step 1: Start Your Migration

Begin by accessing the migration wizard. You'll typically be presented with options to start a do-it-yourself migration or request assistance.

Choose to start a new migration to proceed with the setup process.

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

Since VTEX requires a file-based approach, you will select 'CSVTOCART' as your Source Cart. This indicates that your data will be imported from CSV files.

You will then be prompted to upload your prepared CSV files containing your VTEX store data. Ensure your CSV files are correctly formatted according to the migration tool's requirements.

Step 3: Connect Your Target Store (BigCommerce)

Next, you will configure the connection to your BigCommerce target store. Select 'BigCommerce' from the list of available target carts.

Provide the necessary BigCommerce API credentials: your Client ID, Access Token, and API Path. These details authorize the migration tool to connect securely and transfer data to your new BigCommerce store.

Step 4: Select Entities for Migration

This crucial step allows you to specify which data entities you want to transfer from your VTEX CSV files to BigCommerce. You can typically select all entities or choose specific ones based on your needs.

Common entities for migration include:

• Products (SKUs, variants, product descriptions, images)
• Product Categories
• Customers (customer data, accounts)
• Orders (order history, statuses)
• Coupons
• CMS Pages
• Blogs & Blog Posts

Carefully review the list and select all the data types essential for your new BigCommerce store.

Step 5: Configure Additional Migration Options

Enhance your data transfer with various additional options designed to preserve SEO rankings, improve user experience, and streamline post-migration tasks.

Key options to consider include:

• Clear Target Store Data: This option will remove any existing data on your BigCommerce store before migration, ensuring a clean slate. Read more about Clear current data on Target store before migration option.
• Create 301 SEO URLs: Crucial for maintaining your search engine optimization (SEO) and link equity. This creates redirects from your old VTEX URLs to your new BigCommerce URLs, preventing broken links and preserving your search rankings.
• Preserve IDs: Options to preserve Product IDs, Category IDs, Customer IDs, and Order IDs can be vital for maintaining consistency with external systems or for internal record-keeping. Learn more about How Preserve IDs options can be used?.
• Create Variants from Attributes: Essential for products with multiple options (e.g., size, color) to be correctly structured as product variants on BigCommerce.
• Migrate Images in Description: Ensures that images embedded within product descriptions or blog posts are transferred and correctly linked.
• Migrate Customer Passwords: This feature allows customers to log into their accounts on the new BigCommerce store using their existing passwords.

Select the options that best align with your business requirements.

Step 6: Map Data Fields

Data mapping is a critical step to ensure that information from your VTEX CSV files correctly aligns with the corresponding fields in BigCommerce. This typically involves matching:

• Customer Groups: Map your existing customer groups from VTEX to BigCommerce customer groups or tags.
• Order Statuses: Align the different stages of an order (e.g., 'Pending,' 'Processing,' 'Shipped') from your source to the target platform.
• Product Attributes: Ensure that product attributes and options are mapped correctly to create a consistent product catalog on BigCommerce.

The migration wizard will guide you through this process, often providing dropdown menus for easy selection.

Step 7: Run a Free Demo Migration

Before committing to a 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, orders) to your BigCommerce store.

A demo allows you to:

• Verify the connection between your CSV data and BigCommerce.
• Check the accuracy of data transfer and mapping.
• Identify and resolve any potential issues before the full migration.
• Gain confidence in the migration process.

Step 8: Perform Full Migration

Once you are satisfied with the demo results, proceed to the full data migration. Review the total cost and consider purchasing a Migration Insurance Service, which offers additional re-migrations within a specific period, providing peace of mind.

Initiate the full transfer. The duration will depend on the volume of your data and the speed of the servers. You will be notified once the migration is complete.

Post-Migration Steps

After your data has been successfully transferred to BigCommerce, there are several crucial post-migration tasks to ensure your new store is fully operational and ready for customers.

1. Thoroughly Verify Data: Log into your BigCommerce admin panel and meticulously check all migrated data. Verify products (SKUs, pricing, images, variants), customer accounts, order history, categories, and other content to ensure everything is accurate and complete.
2. Test Store Functionality: Perform comprehensive testing of your new BigCommerce store. This includes testing the checkout process, creating new customer accounts, searching for products, applying coupons, and verifying all payment and shipping methods. Ensure the user experience is flawless.
3. Configure SEO and Redirects: While you hopefully used the 301 redirects option during migration, double-check your SEO settings. Update your sitemaps in BigCommerce and submit them to search engines. Monitor your Google Search Console for any crawl errors or changes in SEO rankings.
4. Install Essential Apps and Integrations: Reinstall and configure any third-party apps, plugins, or integrations that are crucial for your business operations (e.g., email marketing, accounting software, CRM, analytics tools). Explore the BigCommerce App Store for powerful new tools.
5. Set Up Payment and Shipping: Configure your preferred payment gateways (e.g., Stripe, PayPal) and shipping options to ensure a smooth transaction experience for your customers.
6. Update DNS Settings: Once you are confident that your BigCommerce store is fully functional, update your Domain Name System (DNS) records to point your domain to your new BigCommerce store. Plan this step carefully to minimize downtime.
7. Go Live and Announce: Once DNS propagation is complete and your store is fully tested, it's time to officially launch your new BigCommerce store! Announce the transition to your customers and celebrate this exciting new chapter for your business.

If you receive new orders on your old VTEX store during or shortly after the migration, consider using a Recent Data Migration Service to transfer them to BigCommerce without affecting your existing migrated data. Should you encounter any challenges or require expert assistance at any stage, do not hesitate to Contact Us for support.