It's possible to query Shopify resources by metafield value. This is useful if you want to find all products or metaobjects that have a metafield with a specific value.

To query by metafield value, first the metafield you want to query by must have [filtering enabled](/docs/apps/build/custom-data/metafields/use-metafield-capabilities#admin-filterable).

Filtering can also be enabled in the Shopify admin. Learn more about enabling [filtering for product metafields](https://help.shopify.com/en/manual/custom-data/metafields/filtering-products) and [filtering for metaobject fields](https://help.shopify.com/en/manual/custom-data/options).

Available metafield types include:

- Single line text or Single line text (list)
- Product reference or Product reference (list)
- True or false
- Collection reference or Collection reference (list)
- Page reference or Page reference (list)
- Metaobject reference or Metaobject reference (list)
- Company reference or Company reference (list)

> Note:
> Only case-sensitive, exact matches are supported for filtering.

### Querying metaobjects by field value

#### Querying metaobjects by taxonomy reference field value

<p>
<div class="react-stacked-code-block ThemeMode-dim" data-preset="stacked">
<script data-option="title" data-value="POST https://{shop}.myshopify.com/admin/api/{api_version}/graphql.json"></script>


<p>
   <div class="react-code-block" data-preset="basic">
   <div class="react-code-block-preload ThemeMode-dim">
   <div class="react-code-block-preload-bar basic-codeblock"></div>
   <div class="react-code-block-preload-placeholder-container">
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>
   <div class="react-code-block-preload-code-container">
   <div class="react-code-block-preload-codeline-number"></div>
   <div class="react-code-block-preload-codeline"></div>
   </div>

   </div>
   </div>

   <script data-option="title" data-value="GraphQL mutation"></script>

   <script type="text/plain" data-language="graphql">
   RAW_MD_CONTENTquery Metaobjects {
    metaobjects(first: 20, type: "shopify--color-pattern",
    query: "fields.taxonomy_reference:\"gid://shopify/TaxonomyValue/2\"") {
    edges {
        node {
            id
            displayName
            type
            name: field{key: "color_taxonomy_reference"} { value }
            updatedAt
            createdAt
        }
     }
     }
   }
   END_RAW_MD_CONTENT</script>

   </div>
   </p>


</div>
</p>


> Note:
> This example uses the GID structure for the taxonomy node for the `color` blue. You can find GIDs for taxonomy nodes in the open source [Taxonomy Explorer](https://shopify.github.io/product-taxonomy/releases/latest/).


#### Querying metaobjects using a simple single line text field
<p>
<div class="react-stacked-code-block ThemeMode-dim" data-preset="stacked">
<script data-option="title" data-value="POST https://{shop}.myshopify.com/admin/api/{api_version}/graphql.json"></script>


<p>
<div class="react-code-block" data-preset="basic">
<div class="react-code-block-preload ThemeMode-dim">
<div class="react-code-block-preload-bar basic-codeblock"></div>
<div class="react-code-block-preload-placeholder-container">
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>

</div>
</div>

<script data-option="title" data-value="GraphQL mutation"></script>

<script type="text/plain" data-language="graphql">
RAW_MD_CONTENTquery Metaobjects {
  metaobjects(first: 20, type: "custom--product-feature",
    query: "fields.feature_name:\"waterproof\"") {
    edges {
      node {
        id
        displayName
        type
        name: field(key: "feature_name") { value }
        updatedAt
        createdAt
      }
    }
  }
}
END_RAW_MD_CONTENT</script>

</div>
</p>


</div>
</p>


> Note:
> The syntax for querying fields on metaobjects is `fields.{key}:{query_value}`.

### Querying products by field value

<p>
<div class="react-stacked-code-block ThemeMode-dim" data-preset="stacked">
<script data-option="title" data-value="POST https://{shop}.myshopify.com/admin/api/{api_version}/graphql.json"></script>


<p>
<div class="react-code-block" data-preset="basic">
<div class="react-code-block-preload ThemeMode-dim">
<div class="react-code-block-preload-bar basic-codeblock"></div>
<div class="react-code-block-preload-placeholder-container">
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>

</div>
</div>

<script data-option="title" data-value="GraphQL mutation"></script>

<script type="text/plain" data-language="graphql">
RAW_MD_CONTENTquery Products {
  products(first: 20, query: "metafields.custom.material:\"cotton\"") {
    edges {
      node {
        id
        title
        metafield(namespace: "custom", key: "material") {
          value
        }
        updatedAt
        createdAt
      }
    }
  }
}
END_RAW_MD_CONTENT</script>

</div>
</p>


</div>
</p>


> Note:
> The syntax for metafields on core resources (such as products) is `metafields.{namespace}.{key}:{query_value}`.