--- title: discountAutomaticBasicUpdate - GraphQL Admin description: |- Updates an existing [amount off discount](https://help.shopify.com/manual/discounts/discount-types/percentage-fixed-amount) that's automatically applied on a cart and at checkout. > Note: > To update code discounts, use the [`discountCodeBasicUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeBasicUpdate) mutation instead. api_version: 2025-10 api_name: admin type: mutation api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountAutomaticBasicUpdate md: https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountAutomaticBasicUpdate.md --- # discount​Automatic​Basic​Update mutation Requires Apps must have `write_discounts` access scope. Updates an existing [amount off discount](https://help.shopify.com/manual/discounts/discount-types/percentage-fixed-amount) that's automatically applied on a cart and at checkout. *** Note To update code discounts, use the [`discountCodeBasicUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeBasicUpdate) mutation instead. *** ## Arguments * automatic​Basic​Discount [Discount​Automatic​Basic​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DiscountAutomaticBasicInput) required The input data used to update the automatic amount off discount. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The ID of the automatic amount off discount to update. *** ## Discount​Automatic​Basic​Update​Payload returns * automatic​Discount​Node [Discount​Automatic​Node](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticNode) The automatic discount that was updated. * user​Errors [\[Discount​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountUserError) non-null The list of errors that occurred from executing the mutation. *** ## Examples * ### Update an automatic basic discount #### Description Modify an existing automatic discount's percentage discount and make it apply only on a specific collection. #### Query ```graphql mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } } ``` #### Variables ```json { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } }", "variables": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } } }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } }`, { variables: { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } }, }, ); const json = await response.json(); return json.data; } ``` #### Ruby ```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 mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } } QUERY variables = { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } } response = client.query(query: query, variables: variables) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } }`, "variables": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } }, }, }); ``` #### Response ```json { "discountAutomaticBasicUpdate": { "automaticDiscountNode": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "nodes": [ { "id": "gid://shopify/Collection/142458073" } ] } } } } }, "userErrors": [] } } ``` * ### Update context for automatic basic discount for a customer segment #### Description Modify an existing automatic discount's and make it apply only on a specific customer segment. #### Query ```graphql mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { context { ... on DiscountCustomerSegments { segments { id } } } } } } userErrors { field code message } } } ``` #### Variables ```json { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "context": { "customerSegments": { "add": [ "gid://shopify/Segment/210588551" ] } } } } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { context { ... on DiscountCustomerSegments { segments { id } } } } } } userErrors { field code message } } }", "variables": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "context": { "customerSegments": { "add": [ "gid://shopify/Segment/210588551" ] } } } } }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { context { ... on DiscountCustomerSegments { segments { id } } } } } } userErrors { field code message } } }`, { variables: { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "context": { "customerSegments": { "add": [ "gid://shopify/Segment/210588551" ] } } } }, }, ); const json = await response.json(); return json.data; } ``` #### Ruby ```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 mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { context { ... on DiscountCustomerSegments { segments { id } } } } } } userErrors { field code message } } } QUERY variables = { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "context": { "customerSegments": { "add": [ "gid://shopify/Segment/210588551" ] } } } } response = client.query(query: query, variables: variables) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { context { ... on DiscountCustomerSegments { segments { id } } } } } } userErrors { field code message } } }`, "variables": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "context": { "customerSegments": { "add": [ "gid://shopify/Segment/210588551" ] } } } }, }, }); ``` #### Response ```json { "discountAutomaticBasicUpdate": { "automaticDiscountNode": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticDiscount": { "context": { "segments": [ { "id": "gid://shopify/Segment/210588551" } ] } } }, "userErrors": [] } } ``` * ### discountAutomaticBasicUpdate reference [Open in GraphiQL](http://localhost:3457/graphiql?query=mutation%20discountAutomaticBasicUpdate\(%24id%3A%20ID!%2C%20%24automaticBasicDiscount%3A%20DiscountAutomaticBasicInput!\)%20%7B%0A%20%20discountAutomaticBasicUpdate\(id%3A%20%24id%2C%20automaticBasicDiscount%3A%20%24automaticBasicDiscount\)%20%7B%0A%20%20%20%20automaticDiscountNode%20%7B%0A%20%20%20%20%20%20id%0A%20%20%20%20%20%20automaticDiscount%20%7B%0A%20%20%20%20%20%20%20%20...%20on%20DiscountAutomaticBasic%20%7B%0A%20%20%20%20%20%20%20%20%20%20customerGets%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20value%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20...%20on%20DiscountPercentage%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20percentage%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20items%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20...%20on%20DiscountCollections%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20collections\(first%3A%205\)%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20nodes%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20id%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%20%20userErrors%20%7B%0A%20%20%20%20%20%20field%0A%20%20%20%20%20%20code%0A%20%20%20%20%20%20message%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D\&variables=%7B%0A%20%20%22id%22%3A%20%22gid%3A%2F%2Fshopify%2FDiscountAutomaticNode%2F299501151%22%2C%0A%20%20%22automaticBasicDiscount%22%3A%20%7B%0A%20%20%20%20%22customerGets%22%3A%20%7B%0A%20%20%20%20%20%20%22value%22%3A%20%7B%0A%20%20%20%20%20%20%20%20%22percentage%22%3A%200.5%0A%20%20%20%20%20%20%7D%2C%0A%20%20%20%20%20%20%22items%22%3A%20%7B%0A%20%20%20%20%20%20%20%20%22collections%22%3A%20%7B%0A%20%20%20%20%20%20%20%20%20%20%22add%22%3A%20%5B%0A%20%20%20%20%20%20%20%20%20%20%20%20%22gid%3A%2F%2Fshopify%2FCollection%2F142458073%22%0A%20%20%20%20%20%20%20%20%20%20%5D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } }`, { variables: { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } }, }, ); const json = await response.json(); return json.data; } ``` ##### GQL ``` mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } } ``` ##### cURL ``` curl -X POST \ https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } }", "variables": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } } }' ``` ##### React Router ``` import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } }`, { variables: { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } }, }, ); const json = await response.json(); return json.data; } ``` ##### Node.js ``` const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } }`, "variables": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } }, }, }); ``` ##### 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 mutation discountAutomaticBasicUpdate($id: ID!, $automaticBasicDiscount: DiscountAutomaticBasicInput!) { discountAutomaticBasicUpdate(id: $id, automaticBasicDiscount: $automaticBasicDiscount) { automaticDiscountNode { id automaticDiscount { ... on DiscountAutomaticBasic { customerGets { value { ... on DiscountPercentage { percentage } } items { ... on DiscountCollections { collections(first: 5) { nodes { id } } } } } } } } userErrors { field code message } } } QUERY variables = { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } } response = client.query(query: query, variables: variables) ``` ## Input variables JSON ```json { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticBasicDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "add": [ "gid://shopify/Collection/142458073" ] } } } } } ``` ## Response JSON ```json { "discountAutomaticBasicUpdate": { "automaticDiscountNode": { "id": "gid://shopify/DiscountAutomaticNode/299501151", "automaticDiscount": { "customerGets": { "value": { "percentage": 0.5 }, "items": { "collections": { "nodes": [ { "id": "gid://shopify/Collection/142458073" } ] } } } } }, "userErrors": [] } } ```