Updates to Theme Information Access in Shopify
Themes
Effective October 28, 2024
Action required
Action Required:
Developers currently using the BOOMR variables for theme identification and customization should begin transitioning to window.Shopify.theme
properties. The BOOMR variables will be removed on 31/01/2025, after which window.Shopify.theme.schema_name
and window.Shopify.theme.schema_version
should be used exclusively.
Deprecation of BOOMR Script:
The BOOMR (Boomerang) JavaScript library was used for collecting Web Performance data on storefronts and it’s now been replaced with a leaner and more conformant library.
Some theme and app developers had been relying on a few variables set by BOOMR. These variables include:
- BOOMR.themeName
- BOOMR.themeVersion
These variables will continue to be available until 31st Janurary 2025, allowing developers to transition to the new method of accessing theme information.
Introduction of Enhanced Theme Information on window.Shopify.theme:
In response to developer feedback, we are enhancing the window.Shopify.theme
object. Starting today, it will include two new properties:
- schema_name
: Reflects the name
attribute from the theme's settings_schema.json
.
- schema_version
: Reflects the version
attribute from the theme's settings_schema.json
.
These additions aim to provide a standardized and reliable method for accessing theme information directly from the Shopify global object.