---
title: DiscountCodeBasic - GraphQL Admin
description: >-
  The `DiscountCodeBasic` object lets you manage

  [amount off
  discounts](https://help.shopify.com/manual/discounts/discount-types/percentage-fixed-amount)

  that are applied on a cart and at checkout when a customer enters a code.
  Amount off discounts give customers a

  fixed value or a percentage off the products in an order, but don't apply to
  shipping costs.


  The `DiscountCodeBasic` object stores information about amount off code
  discounts that apply to

  specific [products and
  variants](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountProducts),

  [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCollections),

  or [all items in a
  cart](https://shopify.dev/docs/api/admin-graphql/latest/objects/AllDiscountItems).


  Learn more about working with [Shopify's discount
  model](https://shopify.dev/docs/apps/build/discounts),

  including limitations and considerations.


  > Note:

  > The
  [`DiscountAutomaticBasic`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBasic)

  object has similar functionality to the `DiscountCodeBasic` object, but
  discounts are automatically applied,

  without the need for customers to enter a code.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCodeBasic'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCodeBasic.md
---

# Discount​Code​Basic

object

Requires Apps must have `read_discounts` access scope.

The `DiscountCodeBasic` object lets you manage [amount off discounts](https://help.shopify.com/manual/discounts/discount-types/percentage-fixed-amount) that are applied on a cart and at checkout when a customer enters a code. Amount off discounts give customers a fixed value or a percentage off the products in an order, but don't apply to shipping costs.

The `DiscountCodeBasic` object stores information about amount off code discounts that apply to specific [products and variants](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountProducts), [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCollections), or [all items in a cart](https://shopify.dev/docs/api/admin-graphql/latest/objects/AllDiscountItems).

Learn more about working with [Shopify's discount model](https://shopify.dev/docs/apps/build/discounts), including limitations and considerations.

***

**Note:**

The [`DiscountAutomaticBasic`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBasic) object has similar functionality to the `DiscountCodeBasic` object, but discounts are automatically applied, without the need for customers to enter a code.

***

## Fields

* appliesOncePerCustomer
* asyncUsageCount
* codes
* codesCount
* combinesWith
* context
* createdAt
* customerGets
* discountClasses
* endsAt
* hasTimelineComment
* minimumRequirement
* recurringCycleLimit
* shareableUrls
* shortSummary
* startsAt
* status
* summary
* title
* totalSales
* updatedAt
* usageLimit

### Deprecated fields

* customerSelection: deprecated
* discountClass: deprecated

***

## Map

### Possible type in

* [Discount](https://shopify.dev/docs/api/admin-graphql/latest/unions/Discount)
* [Discount​Code](https://shopify.dev/docs/api/admin-graphql/latest/unions/DiscountCode)