Move Your Squarespace Store to nopCommerce with Redirects Intact
The toolkit reads a Squarespace site through the Squarespace Commerce APIs with one read-only Developer API key and imports it into nopCommerce in 9 selectable migration steps: store pages and product categories, physical, service, gift card and download products with variants, customer profiles, orders, discounts, pages and blog posts, and 301 redirects of every old Squarespace URL. Nothing is changed on the Squarespace side.
What It Does
- Store pages and categories — store pages become root categories; the Categories column of the products CSV export becomes their sub-categories, such as /skincare/serums.
- Products with variants — variants become attribute combinations with SKU, price, sale price, stock, weight, dimensions, GTIN, MPN and the variant picture.
- All four product types — service products are not shipped, gift cards get an Amount attribute, download products are imported unpublished with an empty download.
- Customers — customer profiles with addresses, newsletter consent and an optional extra role; subscribers and donors optionally too.
- Order history — orders with tax spread over the items, discounts, refunds, gateway and payment date from the Transactions API, shipments with tracking, numbers prefixed SQ-.
- Discounts — percentage, fixed amount and free shipping codes and automatic discounts; a minimum cart total condition is imported inactive.
- Pages and blog — pages and blog posts of the WordPress site export become topics and blog posts; terms, privacy and shipping pages replace the nopCommerce topics.
- Old URL redirects — /{store page}/p/{product}, store page categories, /{blog}/{post}, the pasted URL mappings with [name] wildcards and fixed paths such as /account answer 301.
- Preview and dry run — Preview counts the objects per step; a dry run downloads everything and logs samples without importing.
- Resumable background runs — Pause, Resume and Cancel; a watchdog task every 5 minutes resumes interrupted runs after an application restart.
- Repeat without duplicates — a mapping table keyed by Squarespace id updates or skips objects changed since the earlier run.
- Undo and clear — undo one run or all runs, or clear the store before a new import.
- Mapping, log and tester — mapping page with CSV export, a filtered migration log, and a tester showing where an old URL redirects.
Selectable Migration Steps
Nine migration steps, each with its expected object count on the dashboard; a step whose API the key cannot read, or whose uploaded file is missing, is shown disabled.
Migration steps
- Categories — store pages as categories; the product categories of the uploaded products CSV as sub-categories
- Products — physical, service, gift card and download products with variants, pictures, tags and stock
- Inventory — re-sync of the stock of the imported products
- Customers — customer profiles with their address, roles and newsletter consent
- Discounts — discount codes and automatic discounts
- Orders — orders with items, addresses, discounts, shipping, fulfillments, refunds and payment details
- Pages — pages of the site export as topics (and the policy pages)
- Blog posts — blog posts and comments of the site export
- Redirects — URL mappings, fixed Squarespace paths and the old URLs of pages and posts
How It Works
- Generate a Developer API key in Squarespace with Read Only permission on the Commerce APIs.
- Enter the site URL and the key on the configuration page and click Check connection.
- Upload the site export and the products CSV, paste the URL mappings, choose the import options.
- On the migration dashboard select the steps, run Preview or a dry run, then start the import.
- Check the mapping and the log, then repeat the run before the switch.
- Point the domain to nopCommerce: the old Squarespace URLs now redirect to the new pages.
Specs & Requirements
- nopCommerce — 5.00, 4.90
- Plugin type — Misc plugin with a redirect middleware and a scheduled watchdog task
- Requires — a Squarespace plan with Developer API keys (Advanced) and a Read Only key for Products, Inventory, Orders, Profiles, Transactions and Discounts
- Store setup — make the Squarespace site currency the primary nopCommerce currency before the import: product prices are imported as they are
- Uploads — files up to 200 MB; IIS refuses requests above about 28.6 MB unless maxAllowedContentLength is raised in web.config
- Not migrated — passwords, navigation menus, download product files, gift card balances, product reviews, Buy X get Y discounts
- Selectable migration steps — 9 steps