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

Product data attributes:

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 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.

This icon represents whether the sourced content is dependent where the product attribute is used 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 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 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 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

This icon represents whether the sourced content is dependent where the product attribute is used 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

This icon represents whether the sourced content is dependent where the product attribute is used 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

This icon represents whether the sourced content is dependent where the product attribute is used 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

This icon represents whether the sourced content is dependent where the product attribute is used 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 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 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]

This icon represents whether the sourced content is dependent where the product attribute is used 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.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
14378969771165756190
true
Search Help Center
true
true
true