image 1
image 2
image 3
Vtex
Squarespace
Circles image
Step-by-Step Migration Guide

Vtex to Squarespace

Migrating your store from Vtex to Squarespace might seem daunting, but with proper planning and the right tools, it's a smooth process. Follow this step-by-step guide to ensure a successful transition.

Schedule a call
Background image
Guide Overview

Step-by-Step Migration Guide: VTEX to Squarespace migration guide

Step 1: Gather Your VTEX API Credentials

Before initiating the migration process, we need to collect the necessary API credentials from your VTEX account. This step is crucial as these credentials will allow our migration tools to access your store's data securely. Here’s how to gather these credentials:

  1. Log into your VTEX Admin Panel: Open a browser and navigate to your VTEX admin panel URL. Enter your credentials to log in.
  2. Access the Application Keys: In the left side menu, click on the Apps icon, then select Application Keys.
  3. Manage Application Keys: Click on the button labeled Manage My Keys. Here, you will find existing keys and options to create new ones.
  4. Create New Application Key: Click the Generate New button. In the label field, input a name for the new key (e.g., “Migration to Squarespace”).
  5. Add Roles: Select the highest role available, typically Owner (Admin Super), to ensure the key has all necessary permissions.
  6. Generate the Key: Click Add Roles, then hit the Generate button. The Application Key and Application Token will be displayed.
  7. Save Your Credentials: Copy both the Application Key and Application Token, and paste them into a secure text file. Make sure to store this file safely as you will need it for the migration process.

By completing these steps, you will have successfully gathered the necessary API credentials needed for the migration to Squarespace.

Step 2: Prepare Your VTEX Store Data for Export

Preparing your store data for export is a critical step in the migration process. This ensures that all necessary data is organized and formatted correctly for Squarespace. Here's how to prepare your VTEX store data:

  1. Determine Data Types: Identify which data types you will need to migrate, such as products, customers, orders, and categories.
  2. Export Product Data: Using the VTEX API, send a request to retrieve your product catalog. You can do this using a REST client (like Postman) and the following endpoint: GET https://{{accountName}}.vtexcommercestable.com.br/api/catalog_system/pvt/products. Ensure you are authenticated with your API credentials.
  3. Export Customer Data: Similarly, request customer data using the endpoint: GET https://{{accountName}}.vtexcommercestable.com.br/api/dataentities/CL/documents. This will allow you to access customer details needed for the migration.
  4. Export Order Data: To migrate orders, use the endpoint: GET https://{{accountName}}.vtexcommercestable.com.br/api/dataentities/OR/documents. This ensures you have all past order information.
  5. Format the Data: Once exported, ensure the data is in a format compatible with Squarespace. This typically means converting your data to CSV or JSON format as required by the Squarespace import tools.
  6. Review and Clean Data: Check for any inconsistencies or errors in the exported data. Clean up any duplicate entries and ensure all fields are correctly filled out.

Completing these steps will ensure that your data is well-prepared and ready for migration into Squarespace.

Step 3: Set Up Your Squarespace Account

Before importing your data into Squarespace, you need to set up your Squarespace account. Follow these steps to create and configure your new account:

  1. Sign Up for Squarespace: Go to the Squarespace website and click on Get Started. You can choose to sign up using your email address or continue with Google or Apple.
  2. Select a Template: After signing up, you will be prompted to choose a template. Squarespace offers a variety of responsive templates that you can customize later, so pick one that closely matches your vision.
  3. Complete the Onboarding Process: Follow the onboarding prompts to set up your site. This includes entering your site name, description, and selecting the type of business you run (e.g., online store).
  4. Access Site Settings: Once your account is set up, go to the Settings panel. Here you will configure your site’s basic settings, including business information, payment processing, and shipping options.
  5. Configure Payment Processing: Set up your payment processors (e.g., Stripe, PayPal) by navigating to Commerce > Payments. Ensure you enter all necessary information to accept payments from your customers.
  6. Set Up Shipping Settings: If you will be selling physical products, configure your shipping settings under Commerce > Shipping. You can define shipping zones, rates, and methods here.

By completing these steps, your Squarespace account will be ready to receive your migrated data efficiently.

Step 4: Import Your Data into Squarespace

Now that your Squarespace account is ready, it’s time to import the prepared data from your VTEX store. Follow these detailed steps to ensure a smooth import:

  1. Access the Import Function: In your Squarespace dashboard, navigate to Commerce > Products. Here, you will see an option to Import your products.
  2. Choose Your Import Method: Squarespace allows you to import products via a CSV file. Select the CSV Import option from the import menu.
  3. Upload Your CSV File: Click Choose File and upload the CSV file that contains your VTEX product data. Ensure that the CSV format follows Squarespace’s guidelines for product imports.
  4. Map Your Data: After uploading, Squarespace will prompt you to map your CSV fields to the corresponding Squarespace fields. Make sure to match correctly, such as product names, descriptions, prices, and images.
  5. Review and Confirm Import: Once mapping is complete, review the import summary to ensure everything looks correct. Confirm the import, and Squarespace will begin processing your products.
  6. Check for Errors: After the import is complete, check for any errors or warnings. If any products failed to import, Squarespace will provide details. You may need to address these issues and re-import specific products as necessary.

After completing these steps, your products should now be available in your Squarespace store, ready for you to customize and display.

Step 5: Transfer Customer Data to Squarespace

Transferring customer data is crucial for maintaining relationships and providing a seamless experience for your existing customers. Here’s how to import your customer data into Squarespace:

  1. Prepare Your Customer CSV: Ensure you have exported your customer data from VTEX in a CSV format. The file should include essential fields such as name, email, phone number, and shipping address.
  2. Navigate to Customer Settings: In your Squarespace dashboard, go to Commerce > Customers.
  3. Import Customers: Click on the Import button, and select the option for a CSV upload.
  4. Upload the Customer CSV: Choose the previously prepared customer CSV file. Squarespace will prompt you to map the customer fields to ensure accuracy.
  5. Map Your Data: Map the fields from your CSV to the corresponding fields in Squarespace, ensuring that emails, names, and addresses are properly aligned.
  6. Review and Confirm: After mapping, review the data import summary. Confirm the import to proceed.
  7. Verify Customer List: Once the import is complete, check the customer list in Squarespace to ensure all data has been imported correctly and is complete.

With this step, your customer data will be safely transferred to Squarespace, allowing you to maintain customer engagement and service continuity.

Step 6: Set Up Squarespace Store Settings

Configuring your store settings in Squarespace is essential for ensuring that your ecommerce functionality is optimized for your business needs. Follow these steps:

  1. Access Store Settings: In your Squarespace dashboard, navigate to Commerce > Settings.
  2. Payment Options: Set up and confirm your payment providers. Ensure that you have enabled the payment methods you want your customers to use, such as credit cards or PayPal.
  3. Shipping Settings: Configure your shipping options under Shipping. You can set shipping rates based on order weight, destination, or offer free shipping options based on conditions.
  4. Tax Settings: Go to Taxes to set up tax rates for different regions if applicable. This ensures that you charge the correct sales tax based on customer locations.
  5. Return Policy: Create a clear return policy and add it under Commerce > Policies. Ensure this is accessible to customers for transparency.
  6. Checkout Settings: Customize the checkout experience by navigating to Checkout settings. You can select whether to allow guest checkouts, gather customer information, and customize the order confirmation emails.

After completing these settings, your Squarespace store will be fully configured and ready for business operations.

Step 7: Test Your Squarespace Store

Testing your Squarespace store is a crucial step before going live. It ensures that all functionalities work correctly and provides a seamless shopping experience for your customers. Here’s how to effectively test your store:

  1. Preview Your Site: Use the preview option within Squarespace to view your site as it will appear to customers. Check for any layout or design inconsistencies.
  2. Test Product Pages: Navigate through your product pages to ensure all product details, images, and variants are displaying correctly.
  3. Conduct Test Purchases: Perform several test transactions using different payment methods. This will help verify that the checkout process works smoothly and that payment processing functions as intended.
  4. Check Shipping Calculations: Ensure that shipping rates are applied correctly during the checkout process. Test with various locations to confirm accurate calculations.
  5. Review Customer Emails: Check the order confirmation and shipping notification emails to ensure they contain the correct information and branding.
  6. Verify Mobile Compatibility: Test your store on mobile devices to ensure that the design is responsive and that the checkout process is seamless on smaller screens.

By thoroughly testing your store, you will be able to identify and rectify any potential issues before launching, ensuring a positive experience for your customers.

Power Your Step - Get in Touch

Are you ready to make the leap from VTEX to Squarespace? Our team at PowerCommerce is here to ensure a seamless migration, backed by over 15 years of industry expertise. By choosing us, you can expect cutting-edge solutions tailored to your specific business needs, facilitating a smooth transition with minimal downtime.

Contact us today to get started:

  1. Visit our Contact Form to fill out your details and request a consultation.
  2. Call us directly at 800-099-9090 for immediate assistance.
  3. Email us at [email protected] for inquiries or to schedule a meeting.

Don’t wait! Let us help you power your ecommerce growth with innovative solutions that drive conversion and optimize storefront performance.

Trusted by 1000+ innovative companies worldwide

Schedule Your Migration Today

For businesses prioritizing simplicity, scalability, and robust support, Shopify is the clear winner.

Looking to migrate without hassle? Power Commerce can handle the entire process, ensuring smooth data transfer, store setup, and post-launch success.


Marka Marulića 2, Sarajevo, 71000 BiH

[email protected]

Tell Us about yourself and we’ll get back to you shortly.

By submitting this form, you agree to Power Commerce's Terms of Service and Privacy Policy.