--- 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-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList md: https://shopify.dev/docs/api/admin-graphql/latest/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/latest/interfaces/Catalog) The catalog that the price list is associated with. * currency [Currency​Code!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/scalars/Int) non-null The number of fixed prices on the price list. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * name [String!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/PriceListParent) Relative adjustments to other prices. * prices [Price​List​Price​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/PriceListPriceConnection) non-null A list of prices associated with the price list. * quantity​Rules [Quantity​Rule​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/QuantityRuleConnection) non-null A list of quantity rules associated with the price list, ordered by product variants. *** ## Map ### Fields and connections with this object * {}[AppCatalog.priceList](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppCatalog#field-AppCatalog.fields.priceList) * ||-[Catalog.priceList](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog#fields-priceList) * {}[CompanyLocationCatalog.priceList](https://shopify.dev/docs/api/admin-graphql/latest/objects/CompanyLocationCatalog#field-CompanyLocationCatalog.fields.priceList) * {}[MarketCatalog.priceList](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCatalog#field-MarketCatalog.fields.priceList) * <->[PriceListConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/PriceListConnection#returns-nodes) * {}[PriceListEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceListEdge#field-PriceListEdge.fields.node) * {}[QuantityPriceBreak.priceList](https://shopify.dev/docs/api/admin-graphql/latest/objects/QuantityPriceBreak#field-QuantityPriceBreak.fields.priceList) *** ## Queries * [price​List](https://shopify.dev/docs/api/admin-graphql/latest/queries/priceList) query Returns a price list resource by ID. * [price​Lists](https://shopify.dev/docs/api/admin-graphql/latest/queries/priceLists) query All price lists for a shop. *** ## \PriceList Queries ### Queried by * \[price​List](https://shopify.dev/docs/api/admin-graphql/latest/queries/PriceList) * \[price​Lists](https://shopify.dev/docs/api/admin-graphql/latest/queries/PriceListConnection) *** ## Mutations * [price​List​Create](https://shopify.dev/docs/api/admin-graphql/latest/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. * [price​List​Fixed​Prices​By​Product​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/priceListFixedPricesByProductUpdate) mutation 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. * [price​List​Fixed​Prices​Update](https://shopify.dev/docs/api/admin-graphql/latest/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​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/priceListUpdate) mutation Updates a price list. If you modify the currency, then any fixed prices set on the price list will be deleted. *** ## <\~> PriceList Mutations ### Mutated by * <\~>[price​List​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/priceListCreate) * <\~>[price​List​Fixed​Prices​By​Product​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/priceListFixedPricesByProductUpdate) * <\~>[price​List​Fixed​Prices​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/priceListFixedPricesUpdate) * <\~>[price​List​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/priceListUpdate) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-PriceList Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)