Remove discount minimum requirement

GraphQL Admin API Troubleshooting
1

Hello,
I’m having troubles updating a DiscountCodeBasic, specifically, removing a minimum requirement.
The documentation says that this discount type shouldn’t be zero, but sending null isn’t working, the update process does nothing.
I’m using the 2024-10 API version in express.js with typescript.

Until now I’ve tried with different values, even with wrong values such as empty string and zero, but no luck. These are my attempts:

  • send null in minimum requirement
  • send zero (obviously fails)
  • Change it to a different type of minimum requirement
  • Omitting the minimum requirement value (set the object property as undefined removes the key:value from the object)
  • Send an empty string ''. This returns that is not a decimal.

Is this feature available?
Deleting and creating the discount again is not a good solution because it would remove the discount usage tracking and other business requirements.

Thanks in advance!!

I’m using this doc reference

This is the payload example.

    {
      "action": "update-coupon",
      "data": {
        "id": "gid://shopify/DiscountCodeNode/1496960663841",
        "basicCodeDiscount": {
          "startsAt": "2023-12-19T00:00:00.000Z",
          "endsAt": "2026-01-01T00:00:00.000Z",
          "customerGets": {
            "value": {
              "discountAmount": {
                "amount": 5000,
                "appliesOnEachItem": false
              }
            },
            "items": {
              "all": true
            }
          },
          "minimumRequirement": null
        }
      }
    }

Note:
minimum requirement says null, but I’ve built the payload using the corresponding structure according the documentation.

        "minimumRequirement": {
          "subtotal": {
            "greaterThanOrEqualToSubtotal": {
              "amount": ""
            }
          }
        }

The graphql query:

export const getDiscountsQuery = `#graphql
query GetDiscounts($query: String = "", $first: Int = 10, $first1: Int = 10, $after: String = "") {
  discountNodes(first: $first, query: $query, after: $after) {
    edges {
      cursor
      node {
        id
        discount {
          ... on DiscountCodeBasic {
            endsAt
            startsAt
            status
            title
            minimumRequirement {
              ... on DiscountMinimumSubtotal {
                __typename
                greaterThanOrEqualToSubtotal {
                  amount
                  currencyCode
                }
              }
            }
            customerGets {
              value {
                ... on DiscountAmount {
                  __typename
                  amount {
                    amount
                  }
                }
                ... on DiscountPercentage {
                  __typename
                  percentage
                }
              }
              items {
                ... on AllDiscountItems {
                  __typename
                  allItems
                }
                ... on DiscountProducts {
                  __typename
                  productVariants(first: $first1) {
                    pageInfo {
                      startCursor
                      hasPreviousPage
                      hasNextPage
                      endCursor
                    }
                    nodes {
                      sku
                      id
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
    pageInfo {
      endCursor
      hasNextPage
      hasPreviousPage
      startCursor
    }
  }
}
`;
2

Hi Aldochaconc,

To update a DiscountCodeBasic and remove the minimumRequirement , you should set the minimumRequirement field to null, but it sounds like this is not working for you. Can you add userErrors to your query to see if there’s any additional info returned on why this is failing?

3

Hi Liam, thanks for the answer.
It seems that I forgot to add the update mutation string and I can’t edit the question.
I’m pasting the query for the update mutation, and as you can see I’m already receiving userErrors if there is any. but requests and responses says everything is ok and the actual discount is not reflecting the changing.

Thanks in advance for your time.

mutation discountCodeBasicUpdate($id: ID!, $basicCodeDiscount: DiscountCodeBasicInput!) {
  discountCodeBasicUpdate(id: $id, basicCodeDiscount: $basicCodeDiscount) {
    codeDiscountNode {
      codeDiscount {
        ... on DiscountCodeBasic {
          title
          startsAt
          endsAt
          status
          codes(first: 10) {
            nodes {
              code
            }
          }
          
          customerSelection {
            ... on DiscountCustomerAll {
              allCustomers
            }
          }
          customerGets {
            value {
              ... on DiscountPercentage {
                percentage
              }
              ... on DiscountOnQuantity {
                quantity {
                  quantity
                }
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
              ... on DiscountProducts {
                productVariants {
                  edges {
                    node {
                      id
                    }
                  }
                }
                products {
                  edges {
                    node {
                      id
                    }
                  }
                }
              }
            }
          }
          minimumRequirement {
            ... on DiscountMinimumQuantity {
              greaterThanOrEqualToQuantity
            }
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}
4

Liam,
I’m also pasting the payload that is not working.

{
  "payload": {
    "id": "gid://shopify/DiscountCodeNode/1497879511329",
    "basicCodeDiscount": {
      "minimumRequirement": null
    }
  },
  "originalData": {
    "id": "gid://shopify/DiscountCodeNode/1497879511329",
    "discount": {
      "__typename": "DiscountCodeBasic",
      "title": "SOMETITLE",
      "minimumRequirement": {
        "__typename": "DiscountMinimumQuantity",
        "greaterThanOrEqualToQuantity": "3" <- not changing after update
      },
      "customerGets": {
        "__typename": "DiscountCustomerGets",
        "value": {
          "__typename": "DiscountPercentage",
          "percentage": 0.07
        },
        "items": {
          "__typename": "AllDiscountItems",
          "allItems": true
        }
      }
    }
  }
}
5

For some reason, the bot deleted the query string that I pasted.
This is the update discount query.
I’m already receiving userErrors if any.
Thanks again!

mutation discountCodeBasicUpdate($id: ID!, $basicCodeDiscount: DiscountCodeBasicInput!) {
  discountCodeBasicUpdate(id: $id, basicCodeDiscount: $basicCodeDiscount) {
    codeDiscountNode {
      codeDiscount {
        ... on DiscountCodeBasic {
          title
          startsAt
          endsAt
          status
          codes(first: 10) {
            nodes {
              code
            }
          }
          
          customerSelection {
            ... on DiscountCustomerAll {
              allCustomers
            }
          }
          customerGets {
            value {
              ... on DiscountPercentage {
                percentage
              }
              ... on DiscountOnQuantity {
                quantity {
                  quantity
                }
              }
              ... on DiscountAmount {
                amount {
                  amount
                }
              }
            }
            items {
              ... on AllDiscountItems {
                allItems
              }
              ... on DiscountProducts {
                productVariants {
                  edges {
                    node {
                      id
                    }
                  }
                }
                products {
                  edges {
                    node {
                      id
                    }
                  }
                }
              }
            }
          }
          minimumRequirement {
            ... on DiscountMinimumQuantity {
              greaterThanOrEqualToQuantity
            }
            ... on DiscountMinimumSubtotal {
              greaterThanOrEqualToSubtotal {
                amount
              }
            }
          }
        }
      }
    }
    userErrors {
      field
      code
      message
    }
  }
}
6

I also had trouble removing a minimumRequirement by sending "minimumRequirement": null in the admin graphql payload. The AI dev chat also recommended this.

However, by looking at the payload when using the shopify admin UI and updating an incentive tier I can see that instead of sending null for the whole object, you have to send an empty minimum requirement object:

         {
            quantity: { greaterThanOrEqualToQuantity: nil },
            subtotal: { greaterThanOrEqualToSubtotal: nil }
          }

That will remove the requirement from the discount code.