---
title: Discounts reference docs improvements - 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/discounts-reference-docs-improvements'
  md: 'https://shopify.dev/changelog/discounts-reference-docs-improvements.md'
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-02-03T19:03:51-05:00'
  postedAt: '2025-02-07T12:00:00-05:00'
  updatedAt: '2025-02-07T12:37:41-05:00'
  effectiveAt: '2025-02-07T12:00:00-05:00'
---

February 7, 2025

Tags:

* Admin GraphQL API

# Discounts reference docs improvements

We’ve rewritten our most-visited and least-loved docs in the **Discounts and marketing** section of the [GraphQL Admin API reference](https://shopify.dev/docs/api/admin-graphql). You've shared many helpful comments and questions through our **Was this page helpful?** form, and we’ve reviewed and addressed 100% of them.

Here’s the lowdown on the latest updates.

## Better descriptions

Many of our descriptions were too brief, circular (restated the method name), expected too much Shopify knowledge, or didn’t link to other relevant docs.

We’ve thoroughly revamped descriptions for Discounts objects, queries (including query filters), mutations, and input objects to include all the details you need without any guesswork. We also added more links to relevant tutorials to make it easier to find your way around and speed up your coding process.

![Improved descriptions for discountCodeApp object](https://cdn.shopify.com/s/files/1/0262/2383/7206/files/discountCodeApp-descs.png?v=1738628466)

## Better examples

We know how helpful it is to see code in action! That’s why we’ve added more real-world examples for common use cases. We added examples across top Discounts pages, especially for pages with 0 examples going in.

![Improved examples for automaticDiscountNode query](https://cdn.shopify.com/s/files/1/0262/2383/7206/files/automaticDiscountNode-examples.png?v=1738628608)

## Thanks for your feedback!

These updates are all about making your life easier. Less time scratching your head or making guesses means more time building amazing things!

We'd love to know what you think—where have these updates helped, and where else in the Admin API docs would you like to see improvements? You can leave comments by clicking the **Was this page helpful?** button on Shopify.dev.