Skip to main content
Competitor assignment controls which competitors apply where. By default a competitor you load in the Competitor prices dataset is available everywhere; assignment narrows it to the specific stores, pricing zones, or sales channels where that competitor actually competes. Use it when different markets or channels face different rivals — so store-level pricing rules and competitor-gap metrics compare against the right set.

​
When to use it

  • Different competitors per country or market.
  • A competitor that only matters online, or only in B2B.
  • Pricing zones that share a competitive set distinct from the rest of your stores.
  • Use the global default instead when one competitor set applies to every store — no assignment needed.

​
Before you start

  • Define your stores, zones, and channels first on the Stores page.
  • Load competitor observations via the Competitor prices dataset or the API. Assignment scopes competitors you already have; it doesn’t create them.

​
Assign a competitor

Competitor assignment lives on the Competitors tab of the Stores page:
  1. Open Stores and switch to the Competitors tab.
  2. Find the competitor you want to scope (use the competitor search).
  3. Assign it to the stores, pricing zones, or channels where it competes.
  4. Save. The assignment takes effect on the next metric refresh and the next agent run.
Assign at the zone or channel level when several stores share the same rivals — every store in the zone or channel inherits the set, so you don’t repeat the assignment per store.

​
How assignment is used

  • Pricing rules — competitor-based rules in Dynamic Pricing (Price Match, parity, undercut) evaluate against the competitors assigned to each product-store combination, so a rule scoped to one channel matches that channel’s competitors.
  • Metrics — per-store competitive metrics (Price Index, CPI, Price Gap, Cheapest Flag) compute against the assigned set, so a store’s gap reflects the rivals it actually faces. See the Metrics glossary.
  • Grid — in SKU-Store view, competitor columns reflect each store’s assigned competitors.

​
Default behavior

A competitor with no explicit assignment stays global — it applies to every store, zone, and channel. Assigning a competitor anywhere scopes it to the assigned set only. Review your global competitors once you start assigning, so a rival meant for one market doesn’t keep skewing gap metrics everywhere.

​
Common pitfalls

  • Double-counting after first assignment — once you scope some competitors, any you leave global still apply everywhere. Decide per competitor whether it’s global or scoped.
  • Empty competitor set for a store — if a store has no assigned competitors and none are global, its competitive metrics come back blank. That’s signal, not a bug.
  • Assigned but no data — assignment scopes which competitors apply; it doesn’t backfill prices. A competitor with no observations for a SKU still shows no gap for that SKU.