Squarespace Store Page Update - August 2025
Other store page changes
This guide describes the changes that Squarespace are making to store and product pages between 18 June and 30 August 2025. Squarespace also rolled out changes to store and product pages in April 2025. These earlier changes were documented here.On 18 June 2025, Squarespace making major behind-the-scenes changes to its Store and Product pages, otherwise known as Product List Pages (PLP or storefront) and Product Detail Pages (PDP).
This structural update is known as βProducts V2β and is designed to improve performance and lay the groundwork for new commerce features, but it may break your existing custom code and plugins.
Who is this guide for?
This guide is for anyone who relies on custom CSS, JavaScript, or injected code to improve product or store pages, regardless of whether you wrote the code yourself, copied a code snippet from a website or purchased a plugin.
Iβm a software developer and Squarespace Expert who has been working with Squarespace for over 15 years. Iβve written this technical guide for anyone who needs to know the changes to class, attribute and structure on Squarespace product pages. This guide may help you to understand why your customisations broke some time between 18 June and 30 August 2025.
This update is mandatory after 30 August 2025
You will need to update your custom code and plugins before 30 August 2025. Squarespace categorically stated that they will not be providing an opt-out for these changes beyond 30 August 2025.
Is my plugin affected?
If you are using one of our plugins, it may be affected by this Squarespace update. Youβll find full details on here,
Why is Squarespace making this change?
This change is part of a broader initiative by Squarespace to modernise their commerce platform. They aim to optimise the underlying DOM structure, improve load performance, and increase consistency across layouts and features.
Looking at the changes in detail, they suggest Squarespace is moving toward a more configurable page that allows for easier customisation of product pages through the Section Settings and Site Styles panels, without requiring custom code.
A summary of the changes
The most notable changes include:
Structural changes: The main product section has been wrapped in a new container div with numerous configuration-based "tweak-" classes. The section ID and primary classes have changed.
Styling approach: There's a shift from direct CSS classes to a more configurable approach using:
Multiple "tweak-" prefixed classes
Inline CSS custom properties (variables) for styling configurations
Resource updates: CSS and JavaScript files have been updated with new versions.
Core component stability: Despite these changes, the core components (gallery, product info, add-to-cart button) maintain similar class and attribute structures, preserving basic functionality.
Itemised list of changes
Squarespace provided an itemised list of the changes in this developer documentation. However, itβs important to know that their documentation is a work in process and isnβt necessarily complete.
Is this information up to date?
The post was published on 18 June 2025 and updated on 1 August 2025. It was correct at that time. This post references the Squarespace V2 Developer Documentation so, as this may change over time, here is a PDF copy saved on 8 July 2025.
