Skip to main content
Skip to main content

Managing Product Price Lists

Create and manage price lists for your products.

  • supplier-price-list-for-productView the price lists for a product.
  • supplier-list-price-list-from-dbView stored price lists.
  • price-list-createCreate and update price lists.
  • price-list-csv-importImport price lists from a CSV file.
  • price-approval-listView the approval status of prices submitted to stores.
  • supplier-batch-request-listView the list of import requests.

Follow this tutorial to set up graduated and volume pricing, including bulk imports and tier configuration.

Open in new tab

Overview​

Price lists provide the tools to manage product pricing across your stores and markets. You can set different prices based on store, geography, time period, and quantity.

For service pricing, see Managing Service Price Lists.

Tip

Looking for technical details? Check out our Price Lists Documentation for API information and advanced features.

Viewing Prices​

  1. Navigate to your product page
  2. Scroll to the prices section
  3. Use filters to view:
    • Approval status (Pending, Approved, Rejected)
    • Store-specific prices
    • Country prices
    • Date ranges

Creating a Single Price​

  1. Select the + Price button in the prices section

  2. Select your store and country/region

  3. Choose your pricing model and enter price details

  4. Add any additional charges (optional)

    Under Are there any additional charges?, select Add a charge to add a tariff, surcharge, duty, levy or handling fee on top of the price. See Adding tariffs and surcharges below.

  5. Set dates (optional)

  6. Configure tax settings (optional)

  7. Set minimum order quantity (optional)

  8. Select Save

Importing Store Prices​

  1. Navigate to Products > File Imports

  2. Select Prices CSV file

  3. Download the template

  4. Fill in your prices

    • Include Store ID for store-specific prices
    • Find Store IDs on the Stores page

Information

If Store ID is empty, prices will be created for all stores you're connected to. If you're not connected to any stores, no prices will be created.

  1. Upload your file

Importing Country Prices​

Follow the same steps as store imports, but:

  1. Leave Store ID empty
  2. Fill in the country column with appropriate country codes
  3. Prices will apply to all your stores in those countries

Importing Catalogue Prices​

For catalogue-specific pricing:

  1. Follow the standard import process
  2. Include the catalogue_identifier in your CSV
  3. Prices will only apply to products in that catalogue

Price Models​

Standard Pricing​

  • Fixed price per unit
  • Simplest pricing model
  • Best for consistent pricing needs

Volume Pricing​

  • Price changes based on total quantity ordered
  • All units get the tier price
  • Optional flat fee per tier

Graduated Pricing​

  • Different prices for different quantity ranges
  • Each tier priced separately
  • Cumulative pricing across tiers

Adding Tariffs and Surcharges​

A price can carry up to five additional charges on top of the unit price: a tariff, surcharge, duty, levy, handling fee or another charge you name. Buyers see the charges itemised next to the price, and their approvers see exactly which charges changed.

Charges are available on standard, volume and graduated prices. They cannot be added to quote or external prices.

Information

Like the price itself, charges cannot be edited once the price is saved. To change a charge, create a new price. A price whose charges changed always goes to the buyer for manual approval, even when the unit price stayed the same.

Adding charges to a single price​

  1. While creating a price, find Are there any additional charges? below the price details

  2. Select Add a charge

  3. Fill in the charge:

    FieldWhat to enter
    ChargeTariff, Surcharge, Duty, Levy, Handling or Other
    Amount typePercentage of the unit price, or a Fixed amount in the price currency
    AmountPercentage points (up to 100) or the fixed amount, greater than zero
    AppliedFixed amounts only: Per unit charges the amount on every unit, Per order line charges it once per order line regardless of quantity
    DescriptionOptional label shown to the buyer, e.g. "EU import tariff"

  4. Repeat Add a charge for further charges, or use the bin icon to remove one

  5. Select Save

Charges are added after promotions and before tax, so a percentage charge is taken from the price the buyer would otherwise pay, and tax is calculated on the price plus charges.

Adding charges with a CSV import​

The prices template repeats five columns for each charge, numbered element_1_ to element_5_:

ColumnRequiredDescription
element_1_typeYes, for each charge you fill intariff, surcharge, duty, levy, handling or other
element_1_amount_typeYes, for each charge you fill inpercentage or fixed
element_1_amountYes, for each charge you fill inGreater than zero. Percentage points, or an amount in the price currency
element_1_apply_perNounit or line. Defaults to unit for fixed charges. Ignored for percentages
element_1_descriptionNoOptional label, up to 191 characters

Leave all five columns empty on rows without charges. A row with a partly filled charge (for example an amount without a type) fails validation, so a price is never imported without a charge you started to declare.

The same columns are available in the products CSV with the price. prefix (price.element_1_type and so on), so you can create a product together with its price and charges in one file.

Viewing charges​

A price with charges shows a charges pill in the prices table. Select the row to expand it and see the Additional charges table listing each charge, its description, its amount and whether it applies per unit, per order line or to the unit price. The same details are shown on the Approvals page.

Tip

For the calculation rules, API payload and export columns, see the Price List Elements documentation.

Checking Price Status​

Navigate to the Approvals page to see:

  • Pending approvals
  • Approved prices
  • Rejected prices

Archiving Prices​

  1. Navigate to Products > File Imports

  2. Select Prices CSV file

  3. Download the template

  4. Fill required fields:

    • type
    • identifier
    • store
    • country
    • Add command column with value archive

  5. Upload your file

Information

When archiving prices, the most recent price for the specified store/country combination will be archived.

Uploading Graduated and Volume Pricing​

Graduated pricing lets you set different price tiers based on quantity ranges. Each tier is priced independently.

1Access the Graduated Pricing Import​

  1. Navigate to File Imports from the left sidebar
File Imports navigation in sidebar
  1. Select the Import button on the file imports landing page
Import button location
  1. Select Prices CSV File from the import options
Prices CSV file selection

2Prepare Graduated Pricing Data​

  1. Download the price template
Template download button
  1. Complete the required fields in the template:
Field NameDescriptionRequirement
CommandUse 'create' for new prices or 'archive' for removing pricesOptional
TypeSpecify 'product', 'product_variant', or 'service'Required
IdentifierProduct, variant, or service identifierRequired
Catalogue IdentifierSpecific catalogue referenceOptional
Billing SchemeMust be 'graduated' for tiered pricingRequired
Store IDStore identifier from stores pageRequired
CountryISO 3166 Alpha-2 country codeRequired
RegionISO 3166 region codeOptional
Starts AtStart date (YYYY-MM-DD)Optional
Ends AtEnd date (YYYY-MM-DD)Optional
Minimum Order QuantityMinimum order amount (≥ 1)Optional
Order Quantity IntervalOrder increment value (≥ 1)Optional
Tax Behaviour'inclusive' or 'exclusive'Optional

Tip

When setting up graduated pricing:

  • Ensure tier ranges don't overlap
  • Start with tier 1 at the lowest quantity
  • Keep tier progressions logical
  • Document tier rationale for future reference

3Import Graduated Pricing​

  1. Review field mappings on the mapping page
Field mapping interface
  1. Verify and submit the import
Import verification and submission

4Monitor Import Status​

Track the status of your graduated pricing imports on the landing page:

Import status monitoring

Note

Graduated pricing imports may require approval before becoming active. Monitor the approval status in the Approvals section.

Common Questions​

QuestionAnswer
How do I change a price?Create a new price list - existing prices can't be edited
How do I set store prices?Include Store ID when creating the price - requires approval
When do public prices become active?Immediately upon creation
When do store prices become active?After procurement approval
Can I delete prices?Use the archive process to remove unwanted prices
How do I add a tariff or surcharge?Add up to five charges when creating the price, or fill in the element_1_* to element_5_* columns of the prices CSV. See Adding tariffs and surcharges
Can I change a charge on its own?No. Create a new price with the new charges. It will need the buyer's approval, even if the unit price is unchanged
PreviousStock, Lead Time & Shipping InformationNextShipping Rules