Configure Shopify B2B price lists with fixed prices and percentage adjustments via the Admin API

In-depth guide

Steps

1. Create a price list using the priceListCreate GraphQL mutation; supply a name, currency, and a parent.adjustment object specifying type (PERCENTAGE_INCREASE or PERCENTAGE_DECREASE) and value (a positive float representing the percentage magnitude).
2. Associate the price list with a B2B catalog by linking it to a CompanyLocation via the catalog configuration; the price list drives pricing for all buyers assigned to that catalog.
3. Add variant-level fixed prices using the priceListFixedPricesAdd mutation; pass an array of up to 250 PriceListFixedPriceInput objects, each with a variantId and price (amount + currencyCode).
4. Understand the override hierarchy: if a variant has a fixed price set on the price list, that fixed price is used; if no fixed price exists, the variant's compare-at or base price is adjusted by the parent percentage adjustment.
5. Update or remove fixed prices with priceListFixedPricesUpdate and priceListFixedPricesDelete; update the percentage adjustment with priceListUpdate targeting the parent.adjustment fields.
6. Query price list details and per-variant prices using the priceList query with the prices connection to verify effective prices before publishing the catalog to buyers.