Choose a version:

priceListUpdate

mutation

Requires write_products access scope. Also: The user must have permission to create and edit catalogs.

Updates a PriceList's configuration, including its name, currency, Catalog association, and pricing adjustments.

Changing the currency removes all fixed prices from the price list. The affected ProductVariant objects revert to prices calculated from the price list's adjustment settings.

Anchor to Arguments

Arguments

Anchor to idid

•ID!

required

The ID of the price list to update.

Anchor to inputinput

•PriceListUpdateInput!

required

The input data used to update the price list.

Show input fields

Was this section helpful?

Anchor to PriceListUpdatePayload returnsPriceListUpdatePayload returns

Anchor to priceListpriceList •PriceList: The updated price list.

Show fields
Anchor to userErrorsuserErrors •[PriceListUserError!]! non-null: The list of errors that occurred from executing the mutation.

Show fields

Was this section helpful?

Examples

Update a price list

Description

Set the existing price list's adjustment to be an increase of 10%.

Query

mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
  priceListUpdate(id: $id, input: $input) {
    priceList {
      id
      parent {
        adjustment {
          type
          value
        }
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}

Variables

{
  "id": "gid://shopify/PriceList/734173888",
  "input": {
    "parent": {
      "adjustment": {
        "value": 10,
        "type": "PERCENTAGE_INCREASE"
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) { priceListUpdate(id: $id, input: $input) { priceList { id parent { adjustment { type value } } } userErrors { message field code } } }",
 "variables": {
    "id": "gid://shopify/PriceList/734173888",
    "input": {
      "parent": {
        "adjustment": {
          "value": 10,
          "type": "PERCENTAGE_INCREASE"
        }
      }
    }
  }
}'

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 priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
    priceListUpdate(id: $id, input: $input) {
      priceList {
        id
        parent {
          adjustment {
            type
            value
          }
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/PriceList/734173888",
        "input": {
            "parent": {
                "adjustment": {
                    "value": 10,
                    "type": "PERCENTAGE_INCREASE"
                }
            }
        }
    },
  },
  );
  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 priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
    priceListUpdate(id: $id, input: $input) {
      priceList {
        id
        parent {
          adjustment {
            type
            value
          }
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/PriceList/734173888",
  "input": {
    "parent": {
      "adjustment": {
        "value": 10,
        "type": "PERCENTAGE_INCREASE"
      }
    }
  }
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
      priceListUpdate(id: $id, input: $input) {
        priceList {
          id
          parent {
            adjustment {
              type
              value
            }
          }
        }
        userErrors {
          message
          field
          code
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/PriceList/734173888",
        "input": {
            "parent": {
                "adjustment": {
                    "value": 10,
                    "type": "PERCENTAGE_INCREASE"
                }
            }
        }
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
  priceListUpdate(id: $id, input: $input) {
    priceList {
      id
      parent {
        adjustment {
          type
          value
        }
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}' \
--variables \
'{
  "id": "gid://shopify/PriceList/734173888",
  "input": {
    "parent": {
      "adjustment": {
        "value": 10,
        "type": "PERCENTAGE_INCREASE"
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
        priceListUpdate(id: $id, input: $input) {
          priceList {
            id
            parent {
              adjustment {
                type
                value
              }
            }
          }
          userErrors {
            message
            field
            code
          }
        }
      }
    `,
    variables: {
        "id": "gid://shopify/PriceList/734173888",
        "input": {
            "parent": {
                "adjustment": {
                    "value": 10,
                    "type": "PERCENTAGE_INCREASE"
                }
            }
        }
    },
  }),
});

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

Response

{
  "priceListUpdate": {
    "priceList": {
      "id": "gid://shopify/PriceList/734173888",
      "parent": {
        "adjustment": {
          "type": "PERCENTAGE_INCREASE",
          "value": 10
        }
      }
    },
    "userErrors": []
  }
}

priceListUpdate reference

Examples

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

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

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

const response = await admin.graphql(

`#graphql

mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {

priceListUpdate(id: $id, input: $input) {

priceList {

parent {

adjustment {

type

value

}

userErrors {

message

field

code

}

}`,

{

variables: {

"id": "gid://shopify/PriceList/734173888",

"input": {

"parent": {

"adjustment": {

"value": 10,

"type": "PERCENTAGE_INCREASE"

}

);

const json = await response.json();

return json.data;

}

GQL

mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
  priceListUpdate(id: $id, input: $input) {
    priceList {
      id
      parent {
        adjustment {
          type
          value
        }
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) { priceListUpdate(id: $id, input: $input) { priceList { id parent { adjustment { type value } } } userErrors { message field code } } }",
 "variables": {
    "id": "gid://shopify/PriceList/734173888",
    "input": {
      "parent": {
        "adjustment": {
          "value": 10,
          "type": "PERCENTAGE_INCREASE"
        }
      }
    }
  }
}'

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 priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
    priceListUpdate(id: $id, input: $input) {
      priceList {
        id
        parent {
          adjustment {
            type
            value
          }
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/PriceList/734173888",
        "input": {
            "parent": {
                "adjustment": {
                    "value": 10,
                    "type": "PERCENTAGE_INCREASE"
                }
            }
        }
    },
  },
  );
  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 priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
      priceListUpdate(id: $id, input: $input) {
        priceList {
          id
          parent {
            adjustment {
              type
              value
            }
          }
        }
        userErrors {
          message
          field
          code
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/PriceList/734173888",
        "input": {
            "parent": {
                "adjustment": {
                    "value": 10,
                    "type": "PERCENTAGE_INCREASE"
                }
            }
        }
    },
  },
});

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 priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
    priceListUpdate(id: $id, input: $input) {
      priceList {
        id
        parent {
          adjustment {
            type
            value
          }
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/PriceList/734173888",
  "input": {
    "parent": {
      "adjustment": {
        "value": 10,
        "type": "PERCENTAGE_INCREASE"
      }
    }
  }
}

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

Shopify CLI

shopify app execute \
--query \
'mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
  priceListUpdate(id: $id, input: $input) {
    priceList {
      id
      parent {
        adjustment {
          type
          value
        }
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}' \
--variables \
'{
  "id": "gid://shopify/PriceList/734173888",
  "input": {
    "parent": {
      "adjustment": {
        "value": 10,
        "type": "PERCENTAGE_INCREASE"
      }
    }
  }
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-07/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation priceListUpdate($id: ID!, $input: PriceListUpdateInput!) {
        priceListUpdate(id: $id, input: $input) {
          priceList {
            id
            parent {
              adjustment {
                type
                value
              }
            }
          }
          userErrors {
            message
            field
            code
          }
        }
      }
    `,
    variables: {
        "id": "gid://shopify/PriceList/734173888",
        "input": {
            "parent": {
                "adjustment": {
                    "value": 10,
                    "type": "PERCENTAGE_INCREASE"
                }
            }
        }
    },
  }),
});

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

Input variables

JSON

{

"id": "gid://shopify/PriceList/734173888",

"input": {

"parent": {

"adjustment": {

"value": 10,

"type": "PERCENTAGE_INCREASE"

}

Response

JSON

{

"priceListUpdate": {

"priceList": {

"id": "gid://shopify/PriceList/734173888",

"parent": {

"adjustment": {

"type": "PERCENTAGE_INCREASE",

"value": 10

}

"userErrors": []

}