--- title: PriceList - GraphQL Admin 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). api_version: 2025-01 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceList' md: 'https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceList.md' --- # Price​List object Requires `read_products` access scope. Also: The user must have a permission to view catalogs. 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). ## Fields * catalog [Catalog](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/Catalog) The catalog that the price list is associated with. * currency [Currency​Code!](https://shopify.dev/docs/api/admin-graphql/2025-01/enums/CurrencyCode) non-null The currency for fixed prices associated with this price list. * fixed​Prices​Count [Int!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Int) non-null The number of fixed prices on the price list. * id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID) non-null A globally-unique ID. * name [String!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String) non-null The unique name of the price list, used as a human-readable identifier. * parent [Price​List​Parent](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceListParent) Relative adjustments to other prices. * prices [Price​List​Price​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/PriceListPriceConnection) non-null A list of prices associated with the price list. * origin​Type [Price​List​Price​Origin​Type](https://shopify.dev/docs/api/admin-graphql/2025-01/enums/PriceListPriceOriginType) ### Arguments The origin of this price, either fixed (defined on the price list) or relative (calculated using an adjustment via a price list parent configuration). * first [Int](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Boolean) Default:false Reverse the order of the underlying list. * query [String](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String) A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax). * * id id * product\_id id - Filter by `id` range. - Example: * `id:1234` * `id:>=1234` * `id:<=1234` * variant\_id id *** * quantity​Rules [Quantity​Rule​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/QuantityRuleConnection) non-null A list of quantity rules associated with the price list, ordered by product variants. * origin​Type [Quantity​Rule​Origin​Type](https://shopify.dev/docs/api/admin-graphql/2025-01/enums/QuantityRuleOriginType) ### Arguments Whether the quantity rule is fixed (defined on the price list) or relative (the default quantity rule for the shop). * first [Int](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Boolean) Default:false Reverse the order of the underlying list. *** *** ## Map ### Fields and connections with this object * {}[AppCatalog.priceList](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/AppCatalog#field-AppCatalog.fields.priceList) * ||-[Catalog.priceList](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/Catalog#fields-priceList) * {}[CompanyLocationCatalog.priceList](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/CompanyLocationCatalog#field-CompanyLocationCatalog.fields.priceList) * {}[MarketCatalog.priceList](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/MarketCatalog#field-MarketCatalog.fields.priceList) * <->[PriceListConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/PriceListConnection#returns-nodes) * {}[PriceListEdge.node](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceListEdge#field-PriceListEdge.fields.node) * {}[QuantityPriceBreak.priceList](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/QuantityPriceBreak#field-QuantityPriceBreak.fields.priceList) *** ## Queries * [price​List](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/priceList) query Returns a price list resource by ID. * id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID) required ### Arguments The ID of the `PriceList` to return. *** * [price​Lists](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/priceLists) query All price lists for a shop. * first [Int](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Int) ### Arguments The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * after [String](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String) The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Price​List​Sort​Keys](https://shopify.dev/docs/api/admin-graphql/2025-01/enums/PriceListSortKeys) Default:ID Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations). *** *** ## \PriceList Queries ### Queried by * \[price​List](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/priceList) * \[price​Lists](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/priceLists) *** ## Mutations * [price​List​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/priceListCreate) mutation 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. * input [Price​List​Create​Input!](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/PriceListCreateInput) required ### Arguments The properties of the new price list. *** * [price​List​Fixed​Prices​By​Product​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/priceListFixedPricesByProductUpdate) mutation Sets or removes fixed prices for all variants of a [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) on a [`PriceList`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList). Simplifies pricing management when all variants of a product should have the same price on a price list, rather than setting individual variant prices. When you add a fixed price for a product, all its [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects receive the same price on the price list. When you remove a product's fixed prices, all variant prices revert to the price list's adjustment rules. * prices​To​Add [\[Price​List​Product​Price​Input!\]](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/PriceListProductPriceInput) ### Arguments A list of `PriceListProductPriceInput` that identifies which products to update the fixed prices for. * prices​To​Delete​By​Product​Ids [\[ID!\]](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID) A list of product IDs that identifies which products to remove the fixed prices for. * price​List​Id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID) required The price list to update the prices for. *** * [price​List​Fixed​Prices​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/priceListFixedPricesUpdate) mutation 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. * price​List​Id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID) required ### Arguments The price list that the prices will be updated against. * prices​To​Add [\[Price​List​Price​Input!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/PriceListPriceInput) required The fixed prices to add. * variant​Ids​To​Delete [\[ID!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID) required A list of product variant IDs to remove from the price list. *** * [price​List​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/priceListUpdate) mutation Updates a price list. If you modify the currency, then any fixed prices set on the price list will be deleted. * id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID) required ### Arguments The ID of the price list to update. * input [Price​List​Update​Input!](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/PriceListUpdateInput) required The input data used to update the price list. *** *** ## <\~> PriceList Mutations ### Mutated by * <\~>[price​List​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/priceListCreate) * <\~>[price​List​Fixed​Prices​By​Product​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/priceListFixedPricesByProductUpdate) * <\~>[price​List​Fixed​Prices​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/priceListFixedPricesUpdate) * <\~>[price​List​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/priceListUpdate) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/Node) interface *** ## ||-PriceList Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/Node)