---
title: The X-Shopify-API-Deprecated-Reason HTTP header will return actual GraphQL deprecations if any - 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/graphql-return-actual-deprecation-reasons
  md: https://shopify.dev/changelog/graphql-return-actual-deprecation-reasons.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

February 24, 2025

Tags:

* Admin GraphQL API
* 2025-04

# The `X-Shopify-API-Deprecated-Reason` HTTP header will return actual GraphQL deprecations if any

As of `2025-04`, the `X-Shopify-API-Deprecated-Reason` HTTP header will return the list of detected deprecations instead of a generic URL.

**Example**

As of `2025-04`: `X-Shopify-API-Deprecated-Reason: Shop.products, Shop.productVariants` Before `2025-04`: `X-Shopify-API-Deprecated-Reason: https://shopify.dev/api/usage/versioning#deprecation-practices`