HubSpot Commerce to Squarespace Migration - Step-by-Step Guide & Expert Services

Migrating from HubSpot Commerce to Squarespace: A Step-by-Step Guide

Replatforming your e-commerce store is a strategic move that can significantly impact your business's future. If you're currently operating on HubSpot Commerce and considering a transition to Squarespace, this comprehensive guide is designed to walk you through every critical step. While HubSpot Commerce offers robust CRM and marketing tools, Squarespace provides an elegant, all-in-one platform known for its design-forward templates and ease of use, particularly for businesses prioritizing aesthetics and integrated solutions.

Given that HubSpot Commerce does not offer direct API-based data export for third-party migration tools, this migration will primarily leverage the CSV file export and import method. This approach ensures that all your essential store data — including products, customers, orders, and more — can be securely transferred to your new Squarespace storefront, maintaining data integrity throughout the transition.

Prerequisites for Migration

Before you begin the actual data transfer, certain preparatory steps are essential to ensure a smooth and successful replatforming process. Addressing these prerequisites will minimize downtime and potential data discrepancies.

1. Prepare Your HubSpot Commerce Data for Export

• Identify Key Data: Pinpoint all the crucial data you need to move. This includes products (with SKUs, variants, descriptions, images), product categories, customer records, order history, product reviews, and any CMS pages or blog posts.
• Export Data to CSV: HubSpot Commerce allows for exporting various data types to CSV files. Systematically export each entity, ensuring all relevant fields are included. For a seamless transfer, it's vital that these CSV files are well-organized and conform to a standard format that can be easily parsed.
• Cleanse Your Data: This is an opportune moment to audit and clean your existing data. Remove outdated products, duplicate customer entries, or irrelevant information. Clean data translates to a cleaner new store.
• Backup Everything: Always create a full backup of your HubSpot Commerce store data before initiating any migration process. This safeguards your information in case of unforeseen issues.

2. Set Up Your New Squarespace Store

• Create a Squarespace Account: If you haven't already, sign up for a Squarespace Commerce plan that suits your business needs.
• Basic Store Setup: Begin setting up the foundational elements of your Squarespace store. Choose a template, configure your basic site settings, and familiarize yourself with the Squarespace dashboard. While data will be migrated, having a skeletal store ready is beneficial.
• Install the Cart2Cart Squarespace Migration App: To facilitate the API connection and data import, you will need to install the Cart2Cart Squarespace Migration App within your Squarespace store. This app acts as the bridge for data transfer.
• Obtain API Credentials: Squarespace requires API access for third-party tools. You'll need to generate necessary credentials, including apiKey, apiSecret, accessToken, and refreshToken, along with your adminEmail and adminPwd. Ensure your Squarespace site is using HTTPS, which is a requirement for API connections. For more details on credentials, refer to The Short & Essential Guide to Access Credentials for Cart2Cart.
• Review Target Store Readiness: Ensure your Squarespace store is ready to receive data. Consider consulting our FAQ on how to prepare your target store for optimal results.

Performing the Migration: A Step-by-Step Guide

With your HubSpot Commerce data ready and your Squarespace store prepped, you can now proceed with the actual migration using a dedicated migration wizard.

Step 1: Initiate Your Migration

Begin the process by navigating to the migration service platform. Here, you'll choose to start a new migration. This initial step sets the stage for defining your source and target platforms.

Step 2: Set Up Your Source Store (HubSpot Commerce via CSV)

Since direct API connection for HubSpot Commerce isn't available, you will select 'CSV File to Cart' as your source platform. You'll then be prompted to upload the CSV files you exported from HubSpot Commerce. These files will contain your crucial business data.

The data entities supported for this CSV import include:

• Products: Including details like SKUs, descriptions, images, and variants.
• Product Categories: Organizing your product catalog.
• Product Reviews: Preserving customer feedback.
• Customers: All customer records and their associated data.
• Orders: Complete order history, crucial for continuity.
• Invoices, Taxes, Stores, Coupons, CMS Pages, Blogs, Blogs Posts: Additional entities to ensure a comprehensive transfer.

For more details on preparing your source store, you might find our FAQ on how to prepare your source store helpful.

Step 3: Connect Your Target Squarespace Store

Next, choose 'Squarespace' as your target e-commerce platform. The migration wizard will then require you to input the connection details gathered during the prerequisites stage.

• Squarespace Admin URL: The URL of your Squarespace administrative panel.
• Admin Email and Password: Your Squarespace administrator credentials.
• API Key, API Secret, Access Token, Refresh Token: These API credentials are vital for the migration service to securely access and import data into your Squarespace store.

Remember, the Cart2Cart Squarespace Migration App must be installed on your Squarespace store to enable this API-based connection, helping to navigate any custom app development or API scope requirements.

Step 4: Select Data Entities for Transfer

This critical step allows you to choose exactly which types of data you want to migrate from your HubSpot Commerce CSV files to Squarespace. You can select all available entities or handpick specific ones based on your needs.

Commonly migrated entities include:

• Products: Ensuring all your inventory, including images and variants, makes the move.
• Product Categories: Maintaining your product organization.
• Customers: Transferring valuable customer data.
• Orders: Preserving transactional history.
• Product Reviews: Retaining social proof.
• CMS Pages & Blogs Posts: Migrating your content marketing efforts.

Step 5: Configure Data Mapping

Data mapping is crucial for ensuring that information from your HubSpot Commerce CSV files correctly aligns with the corresponding fields in Squarespace. This step typically involves matching customer groups, order statuses, and other custom fields to maintain data consistency and integrity.

For example, you'll map 'Pending Payment' in your source data to 'Pending' in Squarespace, or match customer roles effectively. This ensures a logical and accurate transfer of all relevant metadata.

Step 6: Choose Additional Migration Options

Enhance your data transfer by selecting various additional options. These features are designed to optimize your new store and improve the overall user experience.

• Clear Target Store Data: The 'Clear Target' option, found in Squarespace's target options, allows you to remove any existing data on your Squarespace store before the migration begins, ensuring a clean slate. Learn more about clearing target store data.
• Preserve IDs: Opt to 'Preserve Order IDs', 'Preserve Product IDs', or 'Preserve Customer IDs'. This maintains consistency for internal records and external integrations. Discover how Preserve IDs options can be used.
• SEO URLs & 301 Redirects: Critical for maintaining your search engine rankings and link equity. Select 'SEO URLs' and 'Create 301 SEO URLs' to automatically generate redirects for old HubSpot Commerce URLs to their new Squarespace counterparts.
• Migrate Images in Description: Ensures product and category images embedded within descriptions are transferred.
• Password Migration: For customer convenience, you may choose to migrate customer passwords (note: this depends on the encryption methods and security protocols of both platforms).

Step 7: Perform Demo & Full Migration

Before committing to the full replatform, run a free demo migration. This transfers a limited number of entities, allowing you to review the process, check data integrity, and identify any potential issues without cost or risk. After a successful demo, you can proceed with the full migration.

During the full migration setup, you'll also have the option to select a Migration Insurance Plan, offering remigrations within a specified period for added peace of mind. Understand how Migration Insurance works.

Post-Migration Steps

Once the migration wizard has completed its work, your journey isn't over. Several crucial steps remain to ensure your new Squarespace store is fully operational and optimized.

• Thorough Data Verification: Rigorously check all migrated data. Verify product listings (SKUs, variants, prices, images), customer accounts, order histories, CMS pages, and blog posts. Ensure that all data has transferred accurately and completely.
• Test Store Functionality: Act as a customer. Place test orders, process refunds, try different payment gateways, test contact forms, and ensure all site navigation works as expected. Check for mobile responsiveness and overall user experience.
• Update DNS Settings: Once you are confident in your new Squarespace store, update your domain's DNS records to point to Squarespace. This makes your new store live to the public. Plan this step carefully to minimize downtime.
• Review and Optimize SEO: Even with 301 redirects in place, monitor your SEO performance. Verify that all essential metadata (titles, descriptions, alt text) is correctly applied. Squarespace's robust SEO tools can help you fine-tune your new store for search engines.
• Inform Customers: Announce your new platform to your customer base. This is an excellent opportunity to re-engage them and highlight any new features or improvements.
• Remove Old Store: Once your Squarespace store is fully functional and stable, you can decommission your HubSpot Commerce instance. Ensure you retain backups of all historical data for compliance or archival purposes.

Migrating from HubSpot Commerce to Squarespace is a significant undertaking, but by following these detailed steps, you can achieve a seamless and successful transition. For any further assistance or complex requirements, do not hesitate to contact us.