Local inventory data specification

Use this guide to format your local inventory information for Merchant Center. Google uses this data to know which stores have each of your products. Sharing your local inventory data in the correct format is important for creating successful ads and free listings for your products.

In this article

• Formatting your product data
• Definitions

Product data attributes:

• Basic inventory data
• Store pickup data
• Local delivery

Note: Not providing a required attribute may prevent that particular product from showing up in results.

It can take up to 24 hours to sync your business locations into your Merchant Center account, so we recommend that you upload your inventory feed 24 hours after linking accounts, or after a store code is changed or updated in your Business Profiles.

Formatting your product data

Use English when submitting the names of attributes and the values for attributes that use supported values. For example, the availability [availability] attribute uses the supported values In stock, Limited availability, On Display to Order, and Out of stock, which must be submitted in English in order for the system to read them.

Definitions

Required: Submit this attribute. If you don't, your in-store product won't be able to serve in local inventory ads and free local listings.

It depends: You may or may not need to submit this attribute depending on the product or the countries in which your products show.

Basic inventory data

Attribute and format	Minimum requirements at a glance
ID [id] Your product’s unique identifier Required Example A2B4 Syntax Max 50 characters Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)	If you sell the same item in multiple stores, the same ID appears for multiple store codes. You should include one ID [id] attribute per store and change the other attributes accordingly Use the same ID values in both your product data and local inventory data. Only include the products that are generally available for purchase in stores.
Store code [store_code] Your stores unique identifier Required Example A2B4 Syntax Max 64 characters Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)	This attribute is case-sensitive Must match the store codes that you submitted in your Business Profiles.
Availability [availability] Your product's availability in-store Required Example in_stock Supported values In stock [in_stock] Limited availability [limited_availability] On Display to Order [on_display_to_order] Out of stock [out_of_stock] Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)	Accurately submit the product's availability and match the availability to what is in your stores.
Price [price] Your products price in that store Optional Example 15.00 USD Syntax Numeric ISO 4217 Schema.org property: Yes (Learn more about Merchant listing (Product, Offer) structured data on Google Search Central)	Submit price if your item has a different price per store The inventory data price will override the price in the product data feed for the associated store. Accurately submit the product's price and currency, and match with the price from your stores Ensure that the product can be purchased in-store for the submitted price. For products sold in bulk quantities, bundles, or multipacks. Submit the total price of the minimum purchasable quantity, bundle, or multipack. For the US and Canada: Don't include tax in the price. For all other countries: Include value added tax (VAT) or Goods and Services Tax (GST) in the price.
Sale price [sale_price] Your product's sale price Optional Example 15.00 USD Syntax Numeric ISO 4217 Schema.org property: No	Meet the requirements for the price [price] attribute. Submit this attribute (sale price) in addition to the price [price] attribute set to the non-sale price. Accurately submit the product's sale price, and match the sale price from your stores.
Sale price effective date [sale_price_effective_date] The date range during which the sale price applies Optional Example (For UTC+1) 2016-02-24T11:07+0100 / 2016-02-29T23:07+0100 Syntax Max 51 alphanumeric characters ISO 8601 YYYY-MM-DDThh:mm [+hhmm] YYYY-MM-DDThh:mmZ Separate start date and end date with / Schema.org property: No	Use together with the sale price [sale_price] attribute. If you don't submit this attribute (sale price effective date), the sale price always applies. Use a start date before the end date.
Quantity [quantity] The number of items in stock for the store Optional Example 5 Syntax Numeric ISO 4217 Schema.org property: No	If you choose to submit quantity and availability, inventory is classified based on the lower value between your availability and quantity. Google considers "in stock" items to be those with 3+ availability, "limited availability" to be 1-2, and "out of stock" to be 0.

Store pickup data

Add these attributes to your local product inventory feed for store-specific pickup information. Must be provided when using pickup today or pickup later with in-store inventory data.

Attribute and format	Minimum requirements at a glance
Pickup method [pickup_method] Specify the pickup option for this item Optional store-specific pickup information Important: From September 1, 2024 Pickup method [pickup_method] is optional to enable store pickup for your offers. Example buy Supported values Buy [buy] Reserve [reserve] Ship to store [ship to store] Not supported [not supported] Schema.org property: No	Optional for all of the items in your feed that can be picked up in-store. The inventory pickup method will override the pickup method in the product data feed for the associated store.
Pickup SLA [pickup_sla] Specify the expected date that an order will be ready for pickup, relative to when the order is placed. Required store-specific pickup information Example same day Supported values same day [same day] next day [next day] 2-day [2-day] 3-day [3-day] 4-day [4-day] 5-day [5-day] 6-day [6-day] Multi-week [multi-week] Schema.org property: No	Required for all of the items in your feed that can be picked up in-store. Accurately submit the product's pickup SLA and match the pickup SLA from your landing page and checkout pages. The inventory pickup SLA will override the pickup SLA in the product data feed for the associated store.

Local delivery

Attribute and format

Minimum requirements at a glance

Local shipping label [local_shipping_label] Optional Label that you assign to a product to help assign correct shipping costs in Merchant Center account settings Example Sameday Syntax Max 100 characters Schema.org property: No

If you want to enable same-day delivery where only some of your in-store inventory in a particular store is available for same-day delivery, the local shipping label [local_shipping_label] attribute must be added to your local inventory data. The value submitted for this attribute should be the name of the same-day delivery label or labels that you've created in your account-level same-day delivery shipping settings. Each same-day delivery label represents one unique group of same-day delivery settings and will be added to the selected eligible products in your local inventory data. This attribute is optional if either all of your stores and all of your products offer same-day delivery, or if all of your products in a list of eligible stores offer same-day delivery.