Choose a version:

discountNodesCount

query

Requires read_discounts access scope.

The total number of discounts for the shop. Limited to a maximum of 10000 by default.

Anchor to Arguments

Arguments

Anchor to limitlimit •Int Default:10000: The upper bound on count value before returning a result. Use null to have no limit.
Anchor to queryquery •String: A filter made up of terms, connectives, modifiers, and comparators.

name type description acceptable_values default_value example_use
default string Filter by a case-insensitive search of multiple fields
in a document. - query=Bob Norman
- query=title:green hoodie
code string Filter by the discount code. Not supported for bulk discounts. - code:WELCOME10
combines_with string Filter by the [Shopify Functions discount
classes](https://shopify.dev/docs/apps/build/discounts#discount-classes)
that the discount type
can combine with. Supports multiple values separated by commas (e.g.,
combines_with:product_discounts,order_discounts). - order_discounts

product_discounts
- shipping_discounts | | - combines_with:product_discounts
- combines_with:product_discounts,order_discounts | | combines_with.product_discounts_with_tags_on_same_cart_line | string | Filter by a combines with tag applied to discounts on the same cart line. Supports multiple tags separated by commas (e.g., combines_with.product_discounts_with_tags_on_same_cart_line:priority,exclusive). | | | - combines_with.product_discounts_with_tags_on_same_cart_line:priority
- combines_with.product_discounts_with_tags_on_same_cart_line:priority,exclusive | | created_at | time | Filter by the date and time, in the shop's timezone, when the discount was created. | | | - created_at:>'2020-10-21T23:39:20Z'
- created_at:<now
- created_at:<='2024' | | discount_class | string | Filter by the discount class. Supports multiple classes separated by commas (e.g., discount_class:product,order). | - order
- product
- shipping | | - discount_class:product
- discount_class:product,order | | discount_type | string | Filter by the discount type. Supports multiple types separated by commas (e.g., discount_type:percentage,fixed_amount). | - app
- bogo
- fixed_amount
- free_shipping
- percentage | | - discount_type:fixed_amount
- discount_type:percentage,fixed_amount | | ends_at | time | Filter by the date and time, in the shop's timezone, when the discount ends. | | | - ends_at:>'2020-10-21T23:39:20Z'
- ends_at:<now
- ends_at:<='2024' | | id | id | Filter by id range. | | | - id:1234
- id:>=1234
- id:<=1234 | | method | string | Filter by the discount method. Supports multiple methods separated by commas (e.g., method:code,automatic). | - automatic
- code | | - method:code
- method:code,automatic | | starts_at | time | Filter by the date and time, in the shop's timezone, when the discount becomes active and is available for customer use. | | | - starts_at:>'2020-10-21T23:39:20Z'
- starts_at:<now
- starts_at:<='2024' | | status | string | Filter by the status of the discount. Supports multiple statuses separated by commas (e.g., status:active,scheduled). | - active
- expired
- scheduled | | - status:scheduled
- status:active,scheduled | | tag | string | Filter by a tag applied to the discount. Supports multiple tags separated by commas (e.g., tag:loyalty,clearance). | | | - tag:loyalty
- tag:loyalty,clearance | | times_used | integer | Filter by the number of times the discount has been used. For example, if a "Buy 3, Get 1 Free" t-shirt discount is automatically applied in 200 transactions, then the discount has been used 200 times.

This value is updated asynchronously. As a result, it might be different than the actual usage count. | | | - times_used:0

times_used:>150
- times_used:>=200 | | title | string | Filter by the discount name that displays to merchants in the Shopify admin and to customers. | | | - title:Black Friday Sale | | type | string | Filter by the discount type. Supports multiple types separated by commas (e.g., type:percentage,fixed_amount). | - all
- all_with_app
- app
- bxgy
- fixed_amount
- free_shipping
- percentage | | - type:percentage
- type:percentage,fixed_amount | | updated_at | time | Filter by the date and time, in the shop's timezone, when the discount was last updated. | | | - updated_at:>'2020-10-21T23:39:20Z'
- updated_at:<now
- updated_at:<='2024' | You can apply one or more filters to a query. Learn more about Shopify API search syntax.
Anchor to savedSearchIdsavedSearchId •ID: The ID of an existing saved search. The search’s query string is used as the query argument. Refer to the SavedSearch object.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to CountCount

•Count

A numeric count with precision information indicating whether the count is exact or an estimate.

Anchor to countcount

•Int!

non-null

The count of elements.

Anchor to precisionprecision

•CountPrecision!

non-null

The count's precision, or the exactness of the value.

Was this section helpful?

Examples

Retrieve the number of discounts used more than once

Description

Returns the number of discounts that were used more than once.

Query

query discountNodesCount($query: String!) {
  discountNodesCount(query: $query) {
    count
    precision
  }
}

Variables

{
  "query": "times_used:>1"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query discountNodesCount($query: String!) { discountNodesCount(query: $query) { count precision } }",
 "variables": {
    "query": "times_used:>1"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query discountNodesCount($query: String!) {
    discountNodesCount(query: $query) {
      count
      precision
    }
  }`,
  {
    variables: {
        "query": "times_used:>1"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query discountNodesCount($query: String!) {
    discountNodesCount(query: $query) {
      count
      precision
    }
  }
QUERY

variables = {
  "query": "times_used:>1"
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query discountNodesCount($query: String!) {
      discountNodesCount(query: $query) {
        count
        precision
      }
    }`,
    "variables": {
        "query": "times_used:>1"
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'query discountNodesCount($query: String!) {
  discountNodesCount(query: $query) {
    count
    precision
  }
}' \
--variables \
'{
  "query": "times_used:>1"
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query discountNodesCount($query: String!) {
        discountNodesCount(query: $query) {
          count
          precision
        }
      }
    `,
    variables: {
        "query": "times_used:>1"
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountNodesCount": {
    "count": 3,
    "precision": "EXACT"
  }
}

Retrieve the number of discounts used within a range

Description

Returns the number of discounts that were used more than onceand less than four times.

Query

query discountNodesCount($query: String!) {
  discountNodesCount(query: $query) {
    count
    precision
  }
}

Variables

{
  "query": "times_used:>1 AND times_used:<4"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query discountNodesCount($query: String!) { discountNodesCount(query: $query) { count precision } }",
 "variables": {
    "query": "times_used:>1 AND times_used:<4"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query discountNodesCount($query: String!) {
    discountNodesCount(query: $query) {
      count
      precision
    }
  }`,
  {
    variables: {
        "query": "times_used:>1 AND times_used:<4"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query discountNodesCount($query: String!) {
    discountNodesCount(query: $query) {
      count
      precision
    }
  }
QUERY

variables = {
  "query": "times_used:>1 AND times_used:<4"
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query discountNodesCount($query: String!) {
      discountNodesCount(query: $query) {
        count
        precision
      }
    }`,
    "variables": {
        "query": "times_used:>1 AND times_used:<4"
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'query discountNodesCount($query: String!) {
  discountNodesCount(query: $query) {
    count
    precision
  }
}' \
--variables \
'{
  "query": "times_used:>1 AND times_used:<4"
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query discountNodesCount($query: String!) {
        discountNodesCount(query: $query) {
          count
          precision
        }
      }
    `,
    variables: {
        "query": "times_used:>1 AND times_used:<4"
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountNodesCount": {
    "count": 2,
    "precision": "EXACT"
  }
}

Retrieve the number of unused discounts

Description

Returns the number of discounts that were never used.

Query

query discountNodesCount($query: String!) {
  discountNodesCount(query: $query) {
    count
    precision
  }
}

Variables

{
  "query": "times_used:0"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query discountNodesCount($query: String!) { discountNodesCount(query: $query) { count precision } }",
 "variables": {
    "query": "times_used:0"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query discountNodesCount($query: String!) {
    discountNodesCount(query: $query) {
      count
      precision
    }
  }`,
  {
    variables: {
        "query": "times_used:0"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query discountNodesCount($query: String!) {
    discountNodesCount(query: $query) {
      count
      precision
    }
  }
QUERY

variables = {
  "query": "times_used:0"
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query discountNodesCount($query: String!) {
      discountNodesCount(query: $query) {
        count
        precision
      }
    }`,
    "variables": {
        "query": "times_used:0"
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'query discountNodesCount($query: String!) {
  discountNodesCount(query: $query) {
    count
    precision
  }
}' \
--variables \
'{
  "query": "times_used:0"
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query discountNodesCount($query: String!) {
        discountNodesCount(query: $query) {
          count
          precision
        }
      }
    `,
    variables: {
        "query": "times_used:0"
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountNodesCount": {
    "count": 37,
    "precision": "EXACT"
  }
}

Retrieve the total number of discounts

Description

Returns the total number of discounts.

Query

query discountNodesCount {
  discountNodesCount {
    count
    precision
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query discountNodesCount { discountNodesCount { count precision } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query discountNodesCount {
    discountNodesCount {
      count
      precision
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query discountNodesCount {
    discountNodesCount {
      count
      precision
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query discountNodesCount {
    discountNodesCount {
      count
      precision
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query discountNodesCount {
  discountNodesCount {
    count
    precision
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query discountNodesCount {
        discountNodesCount {
          count
          precision
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountNodesCount": {
    "count": 41,
    "precision": "EXACT"
  }
}

Retrieves a count of all price rules

Query

query DiscountCount {
  discountNodesCount {
    count
    precision
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query DiscountCount { discountNodesCount { count precision } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query DiscountCount {
    discountNodesCount {
      count
      precision
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query DiscountCount {
    discountNodesCount {
      count
      precision
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query DiscountCount {
    discountNodesCount {
      count
      precision
    }
  }`,
});

Shopify CLI

shopify app execute \
--query \
'query DiscountCount {
  discountNodesCount {
    count
    precision
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query DiscountCount {
        discountNodesCount {
          count
          precision
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "discountNodesCount": {
    "count": 41,
    "precision": "EXACT"
  }
}

Examples

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query DiscountCount {

discountNodesCount {

count

precision

}

}`,

);

const json = await response.json();

return json.data;

}

GQL

query DiscountCount {
  discountNodesCount {
    count
    precision
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query DiscountCount { discountNodesCount { count precision } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query DiscountCount {
    discountNodesCount {
      count
      precision
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query DiscountCount {
    discountNodesCount {
      count
      precision
    }
  }`,
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query DiscountCount {
    discountNodesCount {
      count
      precision
    }
  }
QUERY

response = client.query(query: query)

Shopify CLI

shopify app execute \
--query \
'query DiscountCount {
  discountNodesCount {
    count
    precision
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-04/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      query DiscountCount {
        discountNodesCount {
          count
          precision
        }
      }
    `,
  }),
});

const { data } = await response.json();
console.log(data);

Response

JSON

{

"discountNodesCount": {

"count": 41,

"precision": "EXACT"

}

name	type	description	acceptable_values	example_use
default	string	Filter by a case-insensitive search of multiple fields
in a document.			- `query=Bob Norman` - `query=title:green hoodie`
code	string	Filter by the discount code. Not supported for bulk discounts.		- `code:WELCOME10`
combines_with	string	Filter by the [Shopify Functions discount
classes](https://shopify.dev/docs/apps/build/discounts#discount-classes)
that the discount type
can combine with. Supports multiple values separated by commas (e.g.,
combines_with:product_discounts,order_discounts).	- `order_discounts`