Inventory Map

Executive Summary

The Inventory Map page helps you understand where your business is performing and where your inventory is positioned by visualizing distribution on an interactive map. It supports two complementary views:

• Sales Distribution shows where units and revenue were generated across the United States by state for your chosen products and date range.
• Stock Level Distribution shows where inventory is currently located across selected marketplaces and regions for your chosen products and date range.

You can use these views to validate demand concentration (where customers are buying), compare demand to inventory placement (where stock is held), and identify regional opportunities or risks (high sales with low stock, or high stock with low sales).

This page is available from Inventory → Inventory Map.

Page Access and Entitlements

Inventory Map is available only to accounts with the required feature enabled.

If your account does not include the Inventory Map feature, the page remains visible in navigation, but the interactive map and controls are replaced by an upgrade-style message. No map data is shown until access is enabled.

Page Layout and Navigation

Inventory Map has two tabs at the top:

1. Sales Distribution
2. Stock Level Distribution

When you switch tabs, the page updates the selected tab in the URL so that the same view can be restored by opening or sharing the link (for example, opening the page with the “stock” tab selected will return you to Stock Level Distribution).

Key Concepts and Metrics

Product Selection

Product Selection determines which products are included in the map calculations and drilldowns. When you add or remove products, the map values and region details update to reflect only the selected products.

Date Range

The Date Range limits which transactions (Sales Distribution) or which inventory snapshots (Stock Level Distribution) are considered in the results. Date ranges are interpreted using full-day boundaries, from the start of the first day through the end of the last day.

Total Sales (Units)

Total Sales (Units) represents the total number of units sold for the selected products during the selected date range. This appears as a summary value on Sales Distribution and is also used to shade each state on the U.S. map.

Total Revenue

Total Revenue represents the total sales value for the selected products during the selected date range. This appears as a summary value on Sales Distribution.

Average Price

Average Price represents an average of recorded price metrics within the selected dataset. It is displayed as a summary metric on Sales Distribution.

Average Price is not necessarily calculated as revenue divided by units for the displayed totals. If you compare the totals, you may see differences depending on how the underlying price metrics are collected and averaged.

Stock Level

Stock Level represents the quantity used to shade regions on the Stock Level Distribution map. Stock Level reflects an end-of-period snapshot logic (described in Operational Logic), rather than a sum across every day in the range.

Occurrences

Occurrences is the count used throughout Stock Level Distribution for region totals and product-level quantities. On the map and in the region dialog, you will see totals expressed as occurrences.

In some parts of the interface, occurrences may be labeled as “units.” The system is still using the same underlying count value.

Marketplaces

Marketplaces define which regions and inventory pools are included in Stock Level Distribution. Unlike Sales Distribution, Stock Level Distribution supports selecting multiple marketplaces at once.

Operational Logic

How Sales Distribution Values Are Built

Sales Distribution organizes results in a hierarchy:

• Overall totals for your selected date range and products
• Breakdowns by period (your chosen range)
• Breakdowns by marketplace (currently fixed to U.S. sales)
• Breakdowns by state
• Breakdowns by product within a state

For each level, the system produces three key metrics:

• Total Sales (Units)
• Total Revenue
• Average Price

The map shading is driven by Total Sales (Units) at the state level.

Average Price Calculation

Average Price is calculated as an arithmetic mean of the available average-price metric values collected in the dataset:

This means it is not necessarily computed from the displayed totals:

If you expect Average Price to always equal Total Revenue divided by Total Sales (Units), you may notice discrepancies. This is expected behavior based on how Average Price is aggregated.

How Stock Level Values Are Built

Stock Level Distribution is designed to represent “how much stock is on hand” using an end-of-period snapshot within your selected date range.

Snapshot-Based Stock Counts

For each grouping, the system selects the latest available date within your chosen date range and uses the ending balance on that date.

Conceptually:

1. Identify the latest available date in the selected range for the relevant grouping.
2. Sum the ending balances for that latest date.
3. Use that sum as the Stock Level (Occurrences) shown on the map and in region totals.

You can think of the logic as:

Stock Level Distribution does not add inventory quantities across all days in the range. Expanding the date range changes which “latest available date” can be selected, but it does not turn the result into a cumulative total.

Location Granularity by Marketplace

Stock Level Distribution uses different location granularity depending on marketplace:

• United States and Canada: Inventory is grouped into meaningful regional locations (for example, derived from fulfillment-center identifiers and mapped to states/provinces).
• Other marketplaces: Inventory is aggregated at the marketplace level. Regional fulfillment-center breakdowns are not available in this view, so the marketplace itself becomes the “location.”

Outside the U.S. and Canada, you should interpret the map as “stock by marketplace region,” not “stock by individual facility.”

User Guide

Common Actions on Inventory Map

Switch Tabs

1. Open Inventory → Inventory Map.
2. Select either Sales Distribution or Stock Level Distribution at the top of the page.
3. The page updates immediately to the chosen dataset and preserves your selection in the URL.

Select Products

1. Use the product selector to choose one or more products.
2. The map updates to show distribution for only those products.
3. Any region drilldown dialog reflects the same product selection.

If product selection is not set or not ready, the map may not load results until selection is available.

Change the Date Range

1. Open the date range control.
2. Select the start and end dates.
3. Apply the selection to refresh map shading, tooltips, and region drilldowns.

Zoom the Map

Use the + and – controls to zoom in and out. This helps when investigating small regions or dense clustering.

Open Region Details

1. Click a state (Sales Distribution) or a region (Stock Level Distribution).
2. A details dialog opens with drilldown information for the selected area.

Loading and Error States

• While map geometry or data is loading, the page displays loading placeholders instead of partial results.
• If the map cannot load, a general error message appears instead of the interactive map.

Sales Distribution Tab

What You See

Sales Distribution displays a U.S. map shaded by units sold by state for your selected products and date range.

The summary area includes:

• Total Sales (Units)
• Total Revenue
• Average Price

Default Date Range

• The default selection is a single day (start of day to end of day).
• For demo environments, the default is based on a fixed reference date.
• For non-demo environments, the default is based on the current day at the time you open the page.

Interpreting the Map

• Darker or more intense shading indicates higher unit sales in that state.
• Hovering shows a tooltip with the state’s units sold for the current filters.

Drilldown: “Sales in: {State}”

Clicking a state opens a dialog titled “Sales in: {State}”.

In the dialog:

• The header includes a badge showing the state’s total units for the current filters.

• The dialog lists products sold in that state, ordered by units sold (highest to lowest).

• Each product entry includes:

  • Product image (when available)
  • Product name
  • ASIN badge
  • SKU badge (when available)

The dialog is designed to prioritize product identification and relative performance ranking by units. Some additional numeric fields may not be displayed depending on configuration and available data in your environment.

Marketplace Scope

Sales Distribution is currently limited to U.S. sales in this view.

If you manage multiple marketplaces and expect to change marketplace scope inside Sales Distribution, that control is not available in the current page behavior.

Stock Level Distribution Tab

What You See

Stock Level Distribution displays a world map shaded by stock level (occurrences) for your selected products, date range, and marketplaces.

A legend indicates relative stock intensity (for example, high versus low stock).

Default Date Range

Stock Level Distribution defaults to a multi-day window (commonly two days ago through today), then uses snapshot logic within that window to determine the stock levels shown on the map.

Select Marketplaces

1. Open the marketplace selector.
2. Choose one or more marketplaces to include.
3. The map updates to show stock distribution for only the selected marketplaces.

A search field may be available within the marketplace selector to help filter the list when many marketplaces are supported.

Interpreting the Map

• Regions with higher occurrences appear more intense on the map.
• Hovering shows a tooltip such as “Stock Level: {value} units” when a region has a value greater than zero.

Drilldown: “Stock Level in: {Location}”

Clicking a region opens a dialog titled “Stock Level in: {location}”, including a badge with the total occurrences for that location.

If detailed product breakdown is available, the dialog includes:

• A Products in this Location section

• A list of products with:

  • Product image (when available)
  • Product name
  • ASIN badge
  • SKU badge (when available)
  • A per-product badge showing “{occurrences} units”

If details are not available for the selection, the dialog shows an empty state message indicating there is no detailed information for that location.

In some cases, a clicked region may not directly map to a stored location label. The system may attempt to match by region name to locate the best available detail record.

System Behaviors and FAQs

Why did my Stock Level not increase when I expanded the date range?

Stock Level Distribution uses the latest available snapshot date within your selected range, not a daily sum. Expanding the range primarily changes which “latest available date” can be selected, rather than accumulating inventory across multiple days.

Why does Stock Level show only marketplace-level locations for some regions?

For marketplaces outside the U.S. and Canada, regional facility-level breakdown is not available in this view, so the system aggregates stock at the marketplace level and treats the marketplace as the location.

Why doesn’t Average Price match Total Revenue divided by Total Sales?

Average Price is calculated as an average of recorded average-price metric values within the dataset, rather than recomputing a single derived value from totals. Depending on how price metrics are emitted for your data, this can differ from $\text{Revenue} / \text{Units}$.

What happens if I have no products selected?

The map results depend on product selection. If no products are selected (or product selection is not yet available), the page may not display mapped results until a valid selection exists.

What if the map is blank or fails to load?

• If the page is still loading, you will see loading placeholders.
• If an error occurs, you will see a general error message instead of the interactive map.
• If you do not have access to the feature, you will see an upgrade-style access message instead of the map.

If you consistently see a blank map with no loading or error message, verify you have selected at least one product, the date range is valid, and you have access to Inventory Map in your plan.