Squarespace Products V2 Update: What it means for your store
If you're running an online store or working with custom code on your Squarespace site, you've probably heard whispers about the big Products V2 transition coming in August. Don’t sweat it — we're breaking down everything you need to know to keep your site running smoothly.
What is Products V2?
Simply put, Products V2 is a significant upgrade to Squarespace's e-commerce system (Commerce V2). It fundamentally reworks the underlying code structure (HTML, CSS, and JavaScript) for your Product Detail Pages (PDPs) and Product Collection Pages.
Why the Change?
Squarespace’s goal is to make the platform faster, cleaner, and more flexible for the future — think better performance and a smoother experience for your customers.
Why Should You Care?
While the visual design of your product pages might not drastically change, the code overhaul directly impacts you if you're using:
Custom CSS/JavaScript: Any custom code you've added to tweak the look or functionality of your product pages is at risk of breaking. Old class names and IDs you once targeted have either changed or been removed.
Third-Party Plugins/Extensions: Any plugins you're using for your product pages will also need to be updated by their developers to ensure compatibility with the new structure.
Crucial Dates to Remember
New websites created after June 30, 2025, are already using Products V2.
All existing eligible websites will be automatically transitioned to Products V2 on August 30, 2025.
Once your site is upgraded, you cannot revert to the previous version.
How to Prepare for the Changes
Proactive preparation is key! Squarespace allows you to opt in early, giving you time to test and fix any issues on your terms. For precise details on the new DOM structure and data-* attributes, always consult the Squarespace Developers documentation: Squarespace Developers: Upcoming Changes (Look for "Detailed Changes by Page and Layout").
Update Custom code
This is often the biggest hurdle. You'll need to review all custom CSS and Code injection on your product-related pages and update your selectors.
Upgrade Plugins
Contact the developers of any third-party plugins you're using to ask about Products V2–compatible versions. Most reputable plugin providers should have updates available or be actively working on them.
Perform a Full Store Audit
After making your code adjustments, thoroughly test your site:
Visit every product page
Add products to your cart
Go through the entire checkout process
Check mobile layouts
Confirm shipping and tax settings
Pro Tip: Don’t just visually inspect your site. Place a test order yourself to confirm the full purchase flow is working correctly.
Use the Migration Tool
When you're confident your site is ready, navigate to your Squarespace dashboard. A migration tool will be available under:
Settings > Selling > Product Settings
My Secret Weapon: Using Web Archive to Spot What Broke
Here’s a quick tip that helped me while updating Lightbox Studio for compatibility with the new Products V2 markup.
How to Spot What Broke
When things looked off, I found it incredibly useful to compare the current version of the site with a snapshot from before the changes.
Squarespace Web Archive
Step-by-step:
Go to web.archive.org
Enter your full domain (e.g., https://yoursite.com)
Open the most recent snapshot of your store/product pages
Open the same pages on your live site
Compare the versions — check for missing layout elements, broken interactions, or visual issues
Example comparison:
Archived (June 2025): https://web.archive.org/web/20250530144418/https://www.jennifertaylorartist.com/originals/p/framed-oil-painting-midnight-sapphire-tynemouth
Live:
https://www.jennifertaylorartist.com/originals/p/framed-oil-painting-midnight-sapphire-tynemouth
Note:
Archive pages are static snapshots — they won’t restore your site, but they’re great for spotting what changed. It’s also a bit of a gamble — not every page gets saved before an update hits.
The Community Effort: Developers Keeping Tabs
You're definitely not alone in this! Many talented Squarespace developers and resource providers are working hard to support the community through this transition:
Beyondspace
At Beyondspace, keeping premium plugins compatible with the latest Squarespace changes is my everyday work. You can rest assured that your tools are being updated, and we’ll be assisting users with any issues arising from the V2 update — especially breaking changes for plugins like Lightbox Studio and Squarespace Datepicker.
SQSP Themes
Their plugins are built to be 100% Squarespace compatible and are continuously maintained to align with platform updates, including Products V2. As a purchaser and newsletter subscriber, I received their update announcement back in mid-July.
Squarewebsites
They are committed to maintaining and updating their plugins (e.g., Universal Filter, Custom Cart Slide Out) to keep pace with Squarespace's rapid UI updates and ensure ongoing functionality.
Final Thoughts
Squarespace Products V2 represents an important step forward for Squarespace, promising better performance for your online store. For those of us who love to customize, it’s a perfect opportunity to refresh our skills and optimize our code.
Stay proactive, test thoroughly, and don’t hesitate to lean on the fantastic Squarespace developer community. Here's to your site running smoothly!
