---
title: Swatches and images for product filters - 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/swatches-and-images-for-product-filters'
  md: 'https://shopify.dev/changelog/swatches-and-images-for-product-filters.md'
metadata:
  effectiveApiVersion: 2024-04
  affectedApi:
    - displayName: Storefront GraphQL API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2024-03-13T14:36:25-04:00'
  postedAt: '2024-03-14T14:15:00-04:00'
  updatedAt: '2024-03-13T16:59:41-04:00'
  effectiveAt: '2024-03-14T14:15:00-04:00'
---

March 14, 2024

Tags:

* Storefront GraphQL API
* 2024-04

# Swatches and images for product filters

As of version 2024-04 of the Storefront API, you can use new attributes of the Filter and FilterValue objects to create [visual filters](https://help.shopify.com/en/manual/online-store/search-and-discovery/filters#visual-filters) for your custom storefront.

We are adding [`FilterValue.swatch`](https://shopify.dev/docs/api/storefront/2024-04/objects/FilterValue#field-filtervalue-swatch) intended for color and pattern swatches and [`FilterValue.image`](https://shopify.dev/docs/api/storefront/2024-04/objects/FilterValue#field-filtervalue-image) for more detailed imagery. Use the new [`Filter.presentation`](https://shopify.dev/docs/api/storefront/2024-04/objects/Filter#field-filter-presentation) attribute to know the intended display of each filter.

Merchants must use Shopify's [Search & Discovery app](https://apps.shopify.com/search-and-discovery) to set visual filters for their store.