Skip to main content

mws inventory history
0 questions
2 posts

Do you have questions about mws inventory history?

Log in to ask questions about mws inventory history publicly or anonymously.

mws_inventory_metric table changed to mws_inventory_health 4/30/21 - MWS dashboard reports affected

Hi , 

The change is here - we have updated the 'mws_inventory_metric' table to now be named the 'mws_inventory_health' table. This DATA STUDIO announcement concerns your MWS data and any dashboard reports that rely on the mws_inventory_metric table.

Related to our emails sent on February 25th and April 2th, we have now changed the 'mws_inventory_metric' table to be a snapshot rather than a historical record, today, Friday, April 30th, and historical data is no longer present in the table. We have also renamed the 'mws_inventory_metric' table as 'mws_inventory_health', which impacts any reporting dashboards relying on the table, including our GDS Operations template.

How does this change impact me?

Any reporting dashboards, charts, or widgets currently relying on data from the mws_inventory_metric table are impacted. This includes any Google Data Studio (GDS) templates that were copied/created from our 'V1 TEMPLATE - dash/DATA STUDIO Amazon Operations Report', specifically impacting the 'Inventory Health' (formerly 'Inventory Summary') page of the report. The template has been updated to reference the new table name and accommodate for the changes required below as of April 30th at 8am MST. So, you can now copy the template or 'Inventory Health' page/widgets again if you'd like the below changes to be 'already done' for you on or after April 30th. You will then want to make sure to 'point' the copied widgets at your own data source(s), which should be updated to reference the 'mws_inventory_health' table name per the prescribed changes outlined below:

What action do I need to take on any reports that rely on the 'mws_inventory_metric' table?

1) You will need to update the impacted items, specifically your GDS data sources, to reference the table name of "mws_inventory_health" instead of "mws_inventory_metric" today and moving forward. You can also remove the 'DateTime' condition from the query as the table will no longer contain historical data. To make the proper data source reference changes, please check out this example shown in GDS:

How to update the table reference in GDS

2) The 'Inventory Health' (formerly 'Inventory Summary') page of the dash GDS template has been affected in that the data shown no longer contains historical data, but rather only contains data as a snapshot from the current day. In particular, this means that the 'Days Out of Stock' field no longer applies and has been removed from the dash template. You are able to track 'Days out of Stock' via the new 'mws_inventory_history' table, which was released on April 23rd per this release note. We also provided a GDS template page that incorporated the new mws_inventory_history data in the linked release note.

3) For those modules and dashboards relying on mws_inventory_metric and including a lookback period such as 'last 30 days', you will want to change the 'Default date range' (i.e. time period of a given widget) to 'Auto' and update any labels or descriptors that describe a lookback period. Additionally, any fields that sum or average numbers over a lookback period can remain, but they will now only reflect one day's worth of data as opposed to a lookback range of data. Here are some examples of the field names that you may want to update:

Detailed Information about the change and why we are doing so (provided on February 25th but including for anyone who missed it):

The MWS report we used to populate our 'mws_inventory_metric' table is a replica of the 'Inventory Health' report you can see in Seller Central under Reports > Fulfillment > Inventory > Inventory Health. However, the Inventory Health report is a "snapshot" and does not allow us to pull historical data. This means we could incur issues of data provision and reliability if MWS happens to be unavailable one day or another....which is highly likely to occur.

If you have grown to enjoy and rely on the inventory data currently seen in the mws_inventory_metric table, fret not as that same data is now shown in the same table under a new name of 'mws_inventory_health'. We have populated the mws_inventory_health table with the same Inventory Health report fields such as Sellable Quantity, Sales Rank, Weeks of Cover, and Inventory Aging to name a few. However, the updated mws_inventory_health table does not track day over day data now that the change has been made; it is rather a snapshot of the current day while historical inventory data is shown in our new inventory history tracking table named 'mws_inventory_history'.

Now that the change is in place, the new inventory history table is populated with information coming from the 'Daily Inventory History' report seen under Reports > Fulfillment > Inventory > Daily Inventory History (this was completed and released as of April 23rd). This allows us to pull historical inventory data not currently available. It also provides us a more consistent and reliable means of tracking day over day inventory amounts, including out of stock instances that we programmatically track (and are not available via any MWS API - out of stock tracking is a dash special).

If you have any questions, please reach out to and we will respond right away.

To a little beta bump,
the dash team

mws v1.0f MWS Inventory History table release for dash/DATA STUDIO - mws_inventory_history

Looking for comprehensive inventory history data and wondering how to track those pesky out of stock instances? We have now released our mws_inventory_history table, which contains daily inventory history data for all items in a given catalog and stores out of stock instances using a little dash deciphering magic.

This dash/DATA STUDIO data release concerns your database and DATA STUDIO subscription with updates for a newly launched table called 'mws_inventory_history'.

Related to our email sent on February 25th, please note that following this release, we will be changing the 'mws_inventory_metric' table to be a snapshot rather than a historical record on Friday, April 30th. At that time, we will rename the 'mws_inventory_metric' table to 'mws_inventory_health', and historical data will no longer be present in the table. We will send a separate heads up email to describe any actions you need to take related to the table name change and snapshot treatment of the data.

What you can now do: With the more reliable inventory history data, you can now track stock levels for each ASIN/SKU in a given seller's catalog, including out of stock instance tracking that cannot be identified without dash's data transformations.

Where the data comes from: Data in the mws_inventory_history table largely ties to the 'Daily Inventory History' report seen in Seller Central under Reports > Fulfillment > Daily Inventory History.

How to use the new data: Dash has created a new page within our GDS Operations Template that displays some of the capabilities of the historical inventory data. The updated template can be copied and used by following the instructions at the link below. Check out the 'GDS operations report' tab of the page to view instructions for copying our template and data sources. As an aside, if you'd just like to copy the new inventory history widgets from the GDS template to your report(s), simply copy and paste the corresponding data sources + widgets from our template to your report. Please note that you'll want to make sure you've copied the underlying data source, pointed it at your db + relevant SellerID value, and then update your widget to use the updated data source 

dash/TRAINING - GDS Operations report

enter password 'dash4you' when prompted

Direct link: GDS Operations Template

What to expect from the new table: We have made a number of enhancements, aggregations, and transformations to the data that materially change how the data is displayed in the dash table vs. the Seller Central report. Generally, the Quantity amounts of inventory shown for each item will tie across the report and the dash table with a few exceptions due to API restrictions and region-specific differences. It is recommended to display/analyze inventory amounts for all marketplaces within a region at once to avoid the API restrictions and display a comprehensive view of your inventory picture. The primary differences and limitations when comparing the Seller Central Daily Inventory History report and the dash mws_inventory_history table data are:

  • Dash includes Merchant Fulfilled item records with available inventory amounts as set by the seller in Seller Central. Merchant Fulfilled items are not included in the Daily Inventory History report.
  • Dash includes 'Out of Stock' item records, which are not included in the Seller Central report.
  • Dash removes the 'fulfillment-center-id' dimension and rather 'rolls up' inventory records by disposition and location. For example, the Seller Central report may return 85 different warehouse locations of inventory for a single item on a given day. To avoid excessive data rows, we have rolled up the inventory amounts to three different 'locations' in our 'InventoryLocation' field of either 'Warehouse', 'In Transfer', or 'MERCHANT_FULFILLED' to designate the amount of inventory in Amazon FBA warehouses, the amount that is in transfer between warehouses, and the amount of merchant fulfilled inventory for a given day, respectively.
  • The MWS API report dash relies on to populate the table does not distinguish which marketplace a given item record 'belongs' to within a region when that item is 'In Transfer' or a Country value for the location of the inventory item is not designated. In these cases, dash populates the record with the marketplace information of the 'default' marketplace of a given region where North America = United States, Europe = United Kingdom, and Far East = Japan. It is this limitation of the API that makes it advisable to display the inventory data for the region as a whole to include all inventory quantities.

*Data delays: At the time of this release, the API has sometimes (not all times) been unable to deliver the previous one or two days' worth of data, returning an error response for the Daily Inventory History report. This means that you may see data up through two days prior to the current date, but missing the inventory history data for the previous one or two days. The data 'catches up' as each day passes but will sometimes exhibit the one or two day gap. We have an open case with Amazon concerning this and will make any updates possible, but this may simply be a limitation or bug in the API.

To view the complete list of updates and related release notes (which we recommend checking out), things you can now do, and items to watch out for concerning the update, just click here: dash/RELEASE NOTES

And don't forget to check out the dash Community Forum for additional info, access to the release notes, the current product roadmap, and a place to ask any questions you have about the update. Community Forum: dash/community forum 

Questions or issues? 

Although we always do extensive quality assurance, new data sets may include a bug here and there. Please let us know if you see any issues by posting in the Community Forum or sending a note to

As always, thank you for being a dash partner. Please let us know how the table is working for you and any questions/issues you come across...any feedback you have is appreciated as always!

To out of stock optics and inventory insights,
The dash team