Add a variant that's already on the order
Description
By default, adding a variant that's already on the order returns a user error. Pass `allowDuplicates: true` to add it again as a separate line item. The change is staged on the `CalculatedOrder` returned by `orderEditBegin`, and is applied to the order when you call `orderEditCommit`.
Query
mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!, $allowDuplicates: Boolean) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity, allowDuplicates: $allowDuplicates) {
calculatedLineItem {
id
quantity
variant {
id
}
}
userErrors {
field
message
}
}
}
Variables
{
"id": "gid://shopify/CalculatedOrder/950617831",
"variantId": "gid://shopify/ProductVariant/1070325018",
"quantity": 1,
"allowDuplicates": true
}
cURL
curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!, $allowDuplicates: Boolean) { orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity, allowDuplicates: $allowDuplicates) { calculatedLineItem { id quantity variant { id } } userErrors { field message } } }",
"variables": {
"id": "gid://shopify/CalculatedOrder/950617831",
"variantId": "gid://shopify/ProductVariant/1070325018",
"quantity": 1,
"allowDuplicates": true
}
}'
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 orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!, $allowDuplicates: Boolean) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity, allowDuplicates: $allowDuplicates) {
calculatedLineItem {
id
quantity
variant {
id
}
}
userErrors {
field
message
}
}
}`,
{
variables: {
"id": "gid://shopify/CalculatedOrder/950617831",
"variantId": "gid://shopify/ProductVariant/1070325018",
"quantity": 1,
"allowDuplicates": true
},
},
);
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
mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!, $allowDuplicates: Boolean) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity, allowDuplicates: $allowDuplicates) {
calculatedLineItem {
id
quantity
variant {
id
}
}
userErrors {
field
message
}
}
}
QUERY
variables = {
"id": "gid://shopify/CalculatedOrder/950617831",
"variantId": "gid://shopify/ProductVariant/1070325018",
"quantity": 1,
"allowDuplicates": true
}
response = client.query(query: query, variables: variables)
Node.js
const client = new shopify.clients.Graphql({session});
const data = await client.query({
data: {
"query": `mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!, $allowDuplicates: Boolean) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity, allowDuplicates: $allowDuplicates) {
calculatedLineItem {
id
quantity
variant {
id
}
}
userErrors {
field
message
}
}
}`,
"variables": {
"id": "gid://shopify/CalculatedOrder/950617831",
"variantId": "gid://shopify/ProductVariant/1070325018",
"quantity": 1,
"allowDuplicates": true
},
},
});
Shopify CLI
shopify app execute \
--query \
'mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!, $allowDuplicates: Boolean) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity, allowDuplicates: $allowDuplicates) {
calculatedLineItem {
id
quantity
variant {
id
}
}
userErrors {
field
message
}
}
}' \
--variables \
'{
"id": "gid://shopify/CalculatedOrder/950617831",
"variantId": "gid://shopify/ProductVariant/1070325018",
"quantity": 1,
"allowDuplicates": true
}'
Direct API Access
const response = await fetch('shopify:admin/api/2026-10/graphql.json', {
method: 'POST',
body: JSON.stringify({
query: `
mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!, $allowDuplicates: Boolean) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity, allowDuplicates: $allowDuplicates) {
calculatedLineItem {
id
quantity
variant {
id
}
}
userErrors {
field
message
}
}
}
`,
variables: {
"id": "gid://shopify/CalculatedOrder/950617831",
"variantId": "gid://shopify/ProductVariant/1070325018",
"quantity": 1,
"allowDuplicates": true
},
}),
});
const { data } = await response.json();
console.log(data);
Response
{
"orderEditAddVariant": {
"calculatedLineItem": {
"id": "gid://shopify/CalculatedLineItem/b7e2d9c4-3a1f-4e6b-8d5c-2f3a4b5c6d7e",
"quantity": 1,
"variant": {
"id": "gid://shopify/ProductVariant/1070325018"
}
},
"userErrors": []
}
}
Add a variant to an order
Description
Stage the addition of three units of a product variant to an order that's being edited. The `id` is the `CalculatedOrder` ID that `orderEditBegin` returns. The new line item appears on the calculated order, and is applied to the order only when you call `orderEditCommit`. Pass `locationId` to choose the location used for inventory and taxes; when you omit it, a default location is chosen.
Query
mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity) {
calculatedLineItem {
id
quantity
title
variant {
id
}
}
calculatedOrder {
id
}
userErrors {
field
message
}
}
}
Variables
{
"id": "gid://shopify/CalculatedOrder/950617830",
"variantId": "gid://shopify/ProductVariant/113655930",
"quantity": 3
}
cURL
curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!) { orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity) { calculatedLineItem { id quantity title variant { id } } calculatedOrder { id } userErrors { field message } } }",
"variables": {
"id": "gid://shopify/CalculatedOrder/950617830",
"variantId": "gid://shopify/ProductVariant/113655930",
"quantity": 3
}
}'
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 orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity) {
calculatedLineItem {
id
quantity
title
variant {
id
}
}
calculatedOrder {
id
}
userErrors {
field
message
}
}
}`,
{
variables: {
"id": "gid://shopify/CalculatedOrder/950617830",
"variantId": "gid://shopify/ProductVariant/113655930",
"quantity": 3
},
},
);
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
mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity) {
calculatedLineItem {
id
quantity
title
variant {
id
}
}
calculatedOrder {
id
}
userErrors {
field
message
}
}
}
QUERY
variables = {
"id": "gid://shopify/CalculatedOrder/950617830",
"variantId": "gid://shopify/ProductVariant/113655930",
"quantity": 3
}
response = client.query(query: query, variables: variables)
Node.js
const client = new shopify.clients.Graphql({session});
const data = await client.query({
data: {
"query": `mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity) {
calculatedLineItem {
id
quantity
title
variant {
id
}
}
calculatedOrder {
id
}
userErrors {
field
message
}
}
}`,
"variables": {
"id": "gid://shopify/CalculatedOrder/950617830",
"variantId": "gid://shopify/ProductVariant/113655930",
"quantity": 3
},
},
});
Shopify CLI
shopify app execute \
--query \
'mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity) {
calculatedLineItem {
id
quantity
title
variant {
id
}
}
calculatedOrder {
id
}
userErrors {
field
message
}
}
}' \
--variables \
'{
"id": "gid://shopify/CalculatedOrder/950617830",
"variantId": "gid://shopify/ProductVariant/113655930",
"quantity": 3
}'
Direct API Access
const response = await fetch('shopify:admin/api/2026-10/graphql.json', {
method: 'POST',
body: JSON.stringify({
query: `
mutation orderEditAddVariant($id: ID!, $variantId: ID!, $quantity: Int!) {
orderEditAddVariant(id: $id, variantId: $variantId, quantity: $quantity) {
calculatedLineItem {
id
quantity
title
variant {
id
}
}
calculatedOrder {
id
}
userErrors {
field
message
}
}
}
`,
variables: {
"id": "gid://shopify/CalculatedOrder/950617830",
"variantId": "gid://shopify/ProductVariant/113655930",
"quantity": 3
},
}),
});
const { data } = await response.json();
console.log(data);
Response
{
"orderEditAddVariant": {
"calculatedLineItem": {
"id": "gid://shopify/CalculatedLineItem/ad4f6c5b-5d0b-4f3c-9c8e-1a2b3c4d5e6f",
"quantity": 3,
"title": "Red Thing",
"variant": {
"id": "gid://shopify/ProductVariant/113655930"
}
},
"calculatedOrder": {
"id": "gid://shopify/CalculatedOrder/950617830"
},
"userErrors": []
}
}