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