Back to Developer changelog

Online Store 2.0: New metafields type system and dynamic sources

API

Effective June 29, 2021

We've released a new commerce-oriented type system for metafields. Metafields that are created with these new types from our APIs are now more interoperable across our system.

You can use the type system through a new type field that replaces the existing valueType field, which is now deprecated. To make the migration easier, this is a non-breaking change. The deprecated valueType field will be removed in 2022-01.

To learn more about the API changes, refer to the API specific reference documentation:

  • Admin REST API
  • Admin GraphQL API
  • Storefront API reference

If you’re a theme developers, then you can now use dynamic sources to insert standard metafields and known resource properties as setting defaults.

Learn more about the type system and how to migrate to it in the Metafields documentation.