Pyle

Featured Offers ​

What This Is ​

Featured Offers are the best resolved prices the system surfaces for shoppers after it evaluates the available product offers for a region, quantity, and offer type.

This is not a normal admin-authored pricing table. It is a system-generated pricing result.

When You Would Use It ​

Use Featured Offers when you need to:

  • understand why a shopper sees a specific price
  • verify the best visible price for a region or offer type
  • troubleshoot differences between raw offer data and storefront pricing

Do not use Featured Offers when you need to author the actual pricing rules. Those live in the underlying product offers and related data inputs.

Before You Start ​

Before you work on a featured-offer issue, make sure:

  • you understand that featured offers are derived from product offers
  • you know the customer, regional, or quantity context that matters
  • you know whether you are investigating a storefront result or an internal order-entry result

How To Use It In The Product ​

There is no dedicated packaged Featured Offers screen in the inspected product.

In practice, teams work with Featured Offers indirectly by:

  1. reviewing the underlying product offers or ERP-fed offer data
  2. checking the shopper-facing product price in the relevant region or context
  3. confirming whether the product has a better public or typed offer available
  4. validating the resulting price through storefront pricing surfaces or internal order-entry selection dialogs

What It Changes In The Storefront ​

Featured Offers affect:

  • the best shopper-visible price for a product
  • region-aware pricing displays
  • some downstream search and pricing-by-province outputs

Common Tasks ​

Review a visible shopper price ​

Compare the shopper-facing price with the underlying offer data.

Troubleshoot a regional price difference ​

Check the regional context and whether a better offer exists for that region and quantity.

Audit offer output ​

Use product-offer export or internal selection flows when you need to compare the raw offer inputs.

Rules, Limits, And Things To Watch ​

  • Featured Offers are generated automatically. You do not manage them the same way you manage promotions.
  • A price difference often comes from underlying offer eligibility, stock, location, or offer type, not from a separate featured-offer form.
  • This first pass did not confirm a packaged admin review screen for featured offers.

Troubleshooting ​

The shopper price looks wrong ​

Start with the underlying product offers, then validate the region, quantity, and offer-type context.

That is expected in the inspected packaged product. Edit the underlying product-offer inputs instead.

The storefront price changed after pricing data changed ​

That can be normal. Featured Offers are recalculated derived pricing snapshots.

Sources ​

  • packages/framework/src/Models/FeaturedOffer.php
  • packages/framework/src/Actions/FeaturedOffer/CalculateFeaturedOffers.php
  • packages/framework/src/Actions/Product/GetDisplayPricesByProvinceCodes.php
  • packages/storefront/src/Livewire/Storefront/Product/OfferBlock.php
  • packages/storefront/src/View/Components/Product/Pricing.php
  • packages/admin/src/Livewire/Admin/Order/Items/AddItemToOrder/ProductOffersDialog.php