Inventory Pricing and Calculations
Overview
Pricing is one of the most important parts of the inventory experience. Marketplace supports a structured pricing model so your site can show clear vehicle pricing, savings, and required disclosures in a consistent way.
Your team typically does not type pricing directly into Sanity. Pricing is synced from your inventory source, then displayed using rules that keep pricing consistent across SRPs and VDPs.
Key pricing concepts
Price categories
A vehicle can have more than one price, depending on the context. Common categories include:
- MSRP: The manufacturer suggested retail price.
- Display price: The primary consumer-facing price shown on the site.
Not every vehicle will have every category. Marketplace uses the best available data for the display experience.
Base price, discounts, rebates
Pricing can include adjustments that affect what the shopper sees.
Common types include:
- Dealer discount: A dealer-applied discount off the base price.
- Manufacturer rebate: A manufacturer-funded incentive.
When these values are available, Marketplace can show them as savings line items and also use them to support sale messaging.
Taxes, fees, and add-ons
Pricing can also include itemized amounts such as:
- Taxes
- Registration or documentation fees
- Destination or freight charges
- Optional add-ons
Whether these appear as itemized line items depends on the location and site configuration.
How pricing is shown on SRPs (search results pages)
SRPs need a single numeric price per vehicle for sorting and filtering.
Marketplace selects a primary price value for each vehicle, typically using:
- Display price when available
- Otherwise, a fallback such as MSRP
This supports:
- Price range filters
- Sorting from low to high
- Consistent vehicle card pricing
If a vehicle is missing a display price, you may see different behavior across vehicles in the same search results.
How pricing is shown on VDPs (vehicle detail pages)
VDPs can show a richer pricing breakdown.
Depending on configuration and available data, a VDP can show:
- The primary display price
- Itemized discounts or rebates
- Itemized taxes and fees
- Required disclaimers
If pricing is configured to be itemized for a location, shoppers may see more detail about how the displayed price is composed.
Sale badges and savings messaging
Marketplace can mark vehicles as on sale when a discount meets a configured threshold.
This is commonly used to power:
- An On Sale badge on SRPs
- Filters for sale inventory
- Savings callouts on VDPs
The threshold and the definition of discount type are part of your project configuration.
Common questions
Why does a price change take time to appear?
Pricing updates depend on your inventory feed timing and the platform sync schedule. After the next inventory refresh, the updated pricing will appear on SRPs and VDPs.
Why is a discount missing?
Discount visibility depends on what your inventory source provides. Some feeds provide a single final price, while others provide a price plus itemized discount entries.
Why does pricing look different across locations?
Locations can have different pricing display settings and different disclaimers. This is most common in multi-rooftop groups where each store has its own policies.
What your team can do
- Keep your inventory feed pricing fields accurate and consistent.
- Decide whether you want itemized discounts and fees on location detail experiences.
- Use per-location policy and disclaimer configuration to ensure compliance for your region and vehicle types.