# PriceList - admin-graphql - OBJECT Version: 2024-10 ## Description Represents a price list, including information about related prices and eligibility rules. You can use price lists to specify either fixed prices or adjusted relative prices that override initial product variant prices. Price lists are applied to customers using context rules, which determine price list eligibility. For more information on price lists, refer to [Support different pricing models](https://shopify.dev/apps/internationalization/product-price-lists). ### Access Scopes `read_products` access scope. ## Fields * [catalog](/docs/api/admin-graphql/2024-10/interfaces/Catalog): Catalog - The catalog that the price list is associated with. * [currency](/docs/api/admin-graphql/2024-10/enums/CurrencyCode): CurrencyCode! - The currency for fixed prices associated with this price list. * [fixedPricesCount](/docs/api/admin-graphql/2024-10/scalars/Int): Int! - The number of fixed prices on the price list. * [id](/docs/api/admin-graphql/2024-10/scalars/ID): ID! - A globally-unique ID. * [name](/docs/api/admin-graphql/2024-10/scalars/String): String! - The unique name of the price list, used as a human-readable identifier. * [parent](/docs/api/admin-graphql/2024-10/objects/PriceListParent): PriceListParent - Relative adjustments to other prices. ## Connections * [prices](/docs/api/admin-graphql/2024-10/connections/PriceListPriceConnection): PriceListPriceConnection! * [quantityRules](/docs/api/admin-graphql/2024-10/connections/QuantityRuleConnection): QuantityRuleConnection! ## Related queries * [priceList](/docs/api/admin-graphql/2024-10/queries/priceList) Returns a price list resource by ID. * [priceLists](/docs/api/admin-graphql/2024-10/queries/priceLists) All price lists for a shop. ## Related mutations * [priceListCreate](/docs/api/admin-graphql/2024-10/mutations/priceListCreate) Creates a price list. You can use the `priceListCreate` mutation to create a new price list and associate it with a catalog. This enables you to sell your products with contextual pricing. * [priceListFixedPricesByProductUpdate](/docs/api/admin-graphql/2024-10/mutations/priceListFixedPricesByProductUpdate) Updates the fixed prices for all variants for a product on a price list. You can use the `priceListFixedPricesByProductUpdate` mutation to set or remove a fixed price for all variants of a product associated with the price list. * [priceListFixedPricesUpdate](/docs/api/admin-graphql/2024-10/mutations/priceListFixedPricesUpdate) Updates fixed prices on a price list. You can use the `priceListFixedPricesUpdate` mutation to set a fixed price for specific product variants or to delete prices for variants associated with the price list. * [priceListUpdate](/docs/api/admin-graphql/2024-10/mutations/priceListUpdate) Updates a price list. If you modify the currency, then any fixed prices set on the price list will be deleted. ## Related Unions ## Examples ### Retrieve Price List Details and Associated Catalog Information Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query { priceList(id: \\\"gid://shopify/PriceList/524058083\\\") { catalog { id title } prices(first: 5, query: \\\"product_id:20995642\\\") { nodes { price { amount currencyCode } variant { id } } } currency parent { adjustment { type value } } } }\"\n}'\n" Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: `query {\n priceList(id: \"gid://shopify/PriceList/524058083\") {\n catalog {\n id\n title\n }\n prices(first: 5, query: \"product_id:20995642\") {\n nodes {\n price {\n amount\n currencyCode\n }\n variant {\n id\n }\n }\n }\n currency\n parent {\n adjustment {\n type\n value\n }\n }\n }\n }`,\n});\n" Ruby example: "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n query {\n priceList(id: \"gid://shopify/PriceList/524058083\") {\n catalog {\n id\n title\n }\n prices(first: 5, query: \"product_id:20995642\") {\n nodes {\n price {\n amount\n currencyCode\n }\n variant {\n id\n }\n }\n }\n currency\n parent {\n adjustment {\n type\n value\n }\n }\n }\n }\nQUERY\n\nresponse = client.query(query: query)\n" Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n query {\n priceList(id: \"gid://shopify/PriceList/524058083\") {\n catalog {\n id\n title\n }\n prices(first: 5, query: \"product_id:20995642\") {\n nodes {\n price {\n amount\n currencyCode\n }\n variant {\n id\n }\n }\n }\n currency\n parent {\n adjustment {\n type\n value\n }\n }\n }\n }`,\n);\n\nconst data = await response.json();\n" Graphql query: "query {\n priceList(id: \"gid://shopify/PriceList/524058083\") {\n catalog {\n id\n title\n }\n prices(first: 5, query: \"product_id:20995642\") {\n nodes {\n price {\n amount\n currencyCode\n }\n variant {\n id\n }\n }\n }\n currency\n parent {\n adjustment {\n type\n value\n }\n }\n }\n}" #### Graphql Input null #### Graphql Response { "data": { "priceList": { "catalog": { "id": "gid://shopify/MarketCatalog/307400570", "title": "Just a simple catalog for a US Price List" }, "prices": { "nodes": [ { "price": { "amount": "9.0", "currencyCode": "USD" }, "variant": { "id": "gid://shopify/ProductVariant/30322695" } }, { "price": { "amount": "13.5", "currencyCode": "USD" }, "variant": { "id": "gid://shopify/ProductVariant/113711323" } }, { "price": { "amount": "13.5", "currencyCode": "USD" }, "variant": { "id": "gid://shopify/ProductVariant/236948360" } } ] }, "currency": "USD", "parent": { "adjustment": { "type": "PERCENTAGE_DECREASE", "value": 10.0 } } } } } ### Retrieve Quantity Rules on Price List Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query { priceList(id: \\\"gid://shopify/PriceList/225060712\\\") { quantityRules(first: 3, originType: FIXED) { nodes { increment maximum minimum productVariant { id title } } } currency } }\"\n}'\n" Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: `query {\n priceList(id: \"gid://shopify/PriceList/225060712\") {\n quantityRules(first: 3, originType: FIXED) {\n nodes {\n increment\n maximum\n minimum\n productVariant {\n id\n title\n }\n }\n }\n currency\n }\n }`,\n});\n" Ruby example: "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n query {\n priceList(id: \"gid://shopify/PriceList/225060712\") {\n quantityRules(first: 3, originType: FIXED) {\n nodes {\n increment\n maximum\n minimum\n productVariant {\n id\n title\n }\n }\n }\n currency\n }\n }\nQUERY\n\nresponse = client.query(query: query)\n" Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n query {\n priceList(id: \"gid://shopify/PriceList/225060712\") {\n quantityRules(first: 3, originType: FIXED) {\n nodes {\n increment\n maximum\n minimum\n productVariant {\n id\n title\n }\n }\n }\n currency\n }\n }`,\n);\n\nconst data = await response.json();\n" Graphql query: "query {\n priceList(id: \"gid://shopify/PriceList/225060712\") {\n quantityRules(first: 3, originType: FIXED) {\n nodes {\n increment\n maximum\n minimum\n productVariant {\n id\n title\n }\n }\n }\n currency\n }\n}" #### Graphql Input null #### Graphql Response { "data": { "priceList": { "quantityRules": { "nodes": [ { "increment": 100, "maximum": 5000, "minimum": 500, "productVariant": { "id": "gid://shopify/ProductVariant/43729076", "title": "151cm" } }, { "increment": 10, "maximum": 1000, "minimum": 100, "productVariant": { "id": "gid://shopify/ProductVariant/138327650", "title": "Default" } }, { "increment": 5, "maximum": null, "minimum": 10, "productVariant": { "id": "gid://shopify/ProductVariant/389013007", "title": "Small" } } ] }, "currency": "USD" } } } ### Retrieve the FIXED prices on a price list Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query { priceList(id: \\\"gid://shopify/PriceList/294167858\\\") { id name prices(first: 10, originType: FIXED) { nodes { price { amount currencyCode } compareAtPrice { amount currencyCode } originType variant { id } } } } }\"\n}'\n" Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: `query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, originType: FIXED) {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n originType\n variant {\n id\n }\n }\n }\n }\n }`,\n});\n" Ruby example: "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, originType: FIXED) {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n originType\n variant {\n id\n }\n }\n }\n }\n }\nQUERY\n\nresponse = client.query(query: query)\n" Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, originType: FIXED) {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n originType\n variant {\n id\n }\n }\n }\n }\n }`,\n);\n\nconst data = await response.json();\n" Graphql query: "query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, originType: FIXED) {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n originType\n variant {\n id\n }\n }\n }\n }\n}" #### Graphql Input null #### Graphql Response { "data": { "priceList": { "id": "gid://shopify/PriceList/294167858", "name": "simple_pricelist", "prices": { "nodes": [ { "price": { "amount": "19.96", "currencyCode": "USD" }, "compareAtPrice": { "amount": "24.99", "currencyCode": "USD" }, "originType": "FIXED", "variant": { "id": "gid://shopify/ProductVariant/113711323" } }, { "price": { "amount": "9.99", "currencyCode": "USD" }, "compareAtPrice": { "amount": "14.99", "currencyCode": "USD" }, "originType": "FIXED", "variant": { "id": "gid://shopify/ProductVariant/498744621" } } ] } } } } ### Retrieve the prices on a price list filtered by product_id Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query { priceList(id: \\\"gid://shopify/PriceList/294167858\\\") { id name prices(first: 10, query: \\\"product_id:20995642\\\") { nodes { price { amount currencyCode } compareAtPrice { amount currencyCode } variant { id product { id } } } } } }\"\n}'\n" Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: `query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, query: \"product_id:20995642\") {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n variant {\n id\n product {\n id\n }\n }\n }\n }\n }\n }`,\n});\n" Ruby example: "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, query: \"product_id:20995642\") {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n variant {\n id\n product {\n id\n }\n }\n }\n }\n }\n }\nQUERY\n\nresponse = client.query(query: query)\n" Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, query: \"product_id:20995642\") {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n variant {\n id\n product {\n id\n }\n }\n }\n }\n }\n }`,\n);\n\nconst data = await response.json();\n" Graphql query: "query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, query: \"product_id:20995642\") {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n variant {\n id\n product {\n id\n }\n }\n }\n }\n }\n}" #### Graphql Input null #### Graphql Response { "data": { "priceList": { "id": "gid://shopify/PriceList/294167858", "name": "simple_pricelist", "prices": { "nodes": [ { "price": { "amount": "10.0", "currencyCode": "USD" }, "compareAtPrice": { "amount": "14.0", "currencyCode": "USD" }, "variant": { "id": "gid://shopify/ProductVariant/30322695", "product": { "id": "gid://shopify/Product/20995642" } } }, { "price": { "amount": "19.96", "currencyCode": "USD" }, "compareAtPrice": { "amount": "24.99", "currencyCode": "USD" }, "variant": { "id": "gid://shopify/ProductVariant/113711323", "product": { "id": "gid://shopify/Product/20995642" } } }, { "price": { "amount": "15.0", "currencyCode": "USD" }, "compareAtPrice": { "amount": "17.0", "currencyCode": "USD" }, "variant": { "id": "gid://shopify/ProductVariant/236948360", "product": { "id": "gid://shopify/Product/20995642" } } } ] } } } } ### Retrieve the prices on a price list filtered by variant_id Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query { priceList(id: \\\"gid://shopify/PriceList/294167858\\\") { id name prices(first: 10, query: \\\"variant_id:498744621\\\") { nodes { price { amount currencyCode } compareAtPrice { amount currencyCode } variant { id } } } } }\"\n}'\n" Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: `query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, query: \"variant_id:498744621\") {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n variant {\n id\n }\n }\n }\n }\n }`,\n});\n" Ruby example: "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, query: \"variant_id:498744621\") {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n variant {\n id\n }\n }\n }\n }\n }\nQUERY\n\nresponse = client.query(query: query)\n" Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, query: \"variant_id:498744621\") {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n variant {\n id\n }\n }\n }\n }\n }`,\n);\n\nconst data = await response.json();\n" Graphql query: "query {\n priceList(id: \"gid://shopify/PriceList/294167858\") {\n id\n name\n prices(first: 10, query: \"variant_id:498744621\") {\n nodes {\n price {\n amount\n currencyCode\n }\n compareAtPrice {\n amount\n currencyCode\n }\n variant {\n id\n }\n }\n }\n }\n}" #### Graphql Input null #### Graphql Response { "data": { "priceList": { "id": "gid://shopify/PriceList/294167858", "name": "simple_pricelist", "prices": { "nodes": [ { "price": { "amount": "9.99", "currencyCode": "USD" }, "compareAtPrice": { "amount": "14.99", "currencyCode": "USD" }, "variant": { "id": "gid://shopify/ProductVariant/498744621" } } ] } } } }