---
title: >-
  Support added for $app in product queries by metafield - 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/posts/support-added-for-app-namespaces-in-product-queries-by-metafield
  md: >-
    https://shopify.dev/changelog/posts/support-added-for-app-namespaces-in-product-queries-by-metafield.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-01-15T19:09:12-05:00'
  postedAt: '2025-01-22T12:00:00-05:00'
  updatedAt: '2025-01-21T12:40:57-05:00'
  effectiveAt: '2025-01-20T12:00:00-05:00'
---

January 22, 2025

# Support added for $app in product queries by metafield

DateJanuary 22, 2025

FlagsUpdate

SurfacesAPI

Affected APIs[GraphQL Admin API](https://shopify.dev/changelog?api_type=admin-graphql)

We now support querying products by app-owned metafields with a saved namespace using the `$app` syntax. To include an app-owned metafield in your query, you can use the syntax `metafields.$app.key:\"value\"` or `metafields.$app\\:optional-additional-text.key:\"value\"`.

[As documented](https://shopify.dev/docs/api/usage/search-syntax#special-characters), special characters need to be escaped from queries. For this reason, you need a `\\` when specifying `:`. For example, suppose you have an app-owned metafield with the optional-additional-text `swatch-app` and key `color` with a value of `green`. To query for products with this metafield, you would use the following search syntax: `"metafields.$app\\:swatch-app.color:\"green\""`

Learn more about [querying products by metafield value](https://shopify.dev/docs/apps/build/custom-data/metafields/query-by-metafield-value) and [creating metafields with reserved namespaces](https://shopify.dev/docs/apps/build/custom-data/ownership#create-metafield-definitions-with-reserved-namespaces).