---
title: >-
  Online Store 2.0: New metafields type system and dynamic sources - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/online-store-2-0-new-metafields-type-system-and-dynamic-sources
  md: >-
    https://shopify.dev/changelog/online-store-2-0-new-metafields-type-system-and-dynamic-sources.md
metadata:
  effectiveApiVersion: 2022-01
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: false
  createdAt: '2021-06-28T12:57:16-04:00'
  postedAt: '2021-06-29T00:00:00-04:00'
  updatedAt: '2024-12-13T17:24:32-05:00'
  effectiveAt: '2021-06-29T00:00:00-04:00'
---

June 29, 2021

Tags:

* API
* 2022-01

# Online Store 2.0: New metafields type system and dynamic sources

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](https://shopify.dev/api/admin-rest/latest/resources/metafield)
* [Admin GraphQL API](https://shopify.dev/api/admin-graphql/latest/objects/Metafield)
* [Storefront API reference](https://shopify.dev/api/storefront/latest/objects/metafield)

If you’re a theme developers, then you can now use [dynamic sources](https://shopify.dev/themes/architecture/settings#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](https://shopify.dev/apps/metafields/definitions/types).