availability: Definition

Use the availability attribute to tell users and us whether you have a product in stock.

When to use

Required for each product

These are the supported values you can choose from:
  • in stock
    You’re currently accepting orders for this product and can fulfill the purchase request. You’re certain that the item will ship (or be in-transit to the customer) in a timely manner because it's available for sale. You can deliver the product to all of the locations that you support in your product data and account shipping settings.
  • out of stock
    You’re not currently accepting orders for this product, or the product is not available for purchase. The product can be in stock on your landing page, but it won’t be shown in ads as long as it has this status. 
  • preorder
    You’re currently taking orders for this product, but it’s not yet been released for sale. You can use the availability_date attribute to indicate the day that the product becomes available for delivery.

Note: The preorder value should only be used for new items and shouldn't be used for existing items that are out of stock and will be back in stock at a later date.

Format

Follow these formatting guidelines to make sure we understand the data you're submitting. 

Supported values
  • in stock
  • out of stock
  • preorder
Repeated field No
Schema.org property
(What's this?)

Offer.availability, Type: ItemAvailability 

How to map to Merchant Center values:

  • in stock: InStock, LimitedAvailability, OnlineOnly
  • out of stock: Discontinued, InStoreOnly, OutOfStock, SoldOut
  • preorder: PreOrder, PreSale
 
File format Example value
Text feeds

in stock

XML feeds <g:availability>in stock</g:availability>


For format API information, please see Content API for Shopping.

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of your Merchant Center account. 

  • Indicate the product availability on your landing page. Learn more about requirements for Shopping ads landing pages.
  • Match availability with your account shipping settings. Learn more about shipping settings.
    • Ship the product to all of the locations that you support in your product data and account shipping settings. This way the availability that users see will match what you submit. 
    • Match availability on your landing page and in your product data. When users come to your landing page, they expect to see the same availability that's provided in your product data. One common availability mismatch is that your shipping settings don’t reflect your delivery locations correctly. For example, make sure that you can physically deliver a product to the state of California through specifying shipping costs for a delivery to California. Learn more about shipping settings
    • Make sure the product can be shipped, not just picked up in store. In-store pickup is not currently supported.
  • Provide the most up-to-date data. Availability and prices of your items can change quite frequently. Learn best practices for maintaining high-quality product data.

Best practices

These are best practices that can help you go beyond the basic requirements to optimize your product data for performance. 

  • Set availability to out of stock when your product is temporarily unavailable in the target country. If we find that a product is "out of stock" on your landing page, but in stock in your product data, we'll disapprove the product. The reason for the disapproval is to prevent you from paying for clicks to your product when you're not actually able to sell it. Instead of getting disapproved or confusing potential customers, let us know that a product has gone out of stock so we can stop ads from showing until you're able to sell the product again.
  • Set availability to out of stock when you take your website down for maintenance or a holiday. Ads for your products will stop showing until your website is ready to receive traffic again and you update your products to use in stock. By following this best practice, you'll prevent unnecessary disapprovals in your account and get your ads running again more quickly than if they'd been disapproved. Learn more best practices for landing page maintenance or a site outage.
  • Don't use out of stock for products that you're no longer selling. Remove any discontinued products from your product data.
  • Consider using automatic item updates to help you avoid availability mismatches. Automatic item updates is a feature that uses your landing page status to automatically update your product data, preventing disapprovals. Learn how to set up automatic item updates. 

Examples

Product is available for sale

An illustration of an android plush

Product Android Squishable
availability in stock
Product inventory ran out

An illustration of an android plush

Product Android Squishable
availability out of stock
Temporarily prevent a product from showing in ads

If you set a product to out of stock in your product data, it won’t show in ads. If you like, you can still have the product show up as "in stock" on your landing page. You can use this method to temporarily stop advertising a product.

An illustration of an android plush

Product Android Squishable
Landing page availability in stock
availability out of stock
Shown in ads? No
   
Product Android Squishable
Landing page availability in stock
availability in stock
Shown in ads? Yes
   
Product Android Squishable
Landing page availability out of stock
availability out of stock
Shown in ads? No
Planned website outage

Even though you still have inventory and could sell your product, you're planning to take your website down for maintenance for a few hours. Learn more best practices for landing page maintenance or a site outage.

Maintenance status Not started
Product Android Squishable
availability in stock
   
Maintenance status In progress
Product Android Squishable
availability out of stock
   
Maintenance status Complete
Product Android Squishable
availability in stock
Variants

If your product comes in multiple colors or sizes, you might also have different availability for each of these variants. For example:

An example of ads without placeholder images

Product Google T-shirt
title Google T-Shirt - Green - Small
price 10.99 USD
availability in stock
color green
size s
id 9876-S-GRN
item_group_id 9876
   
Product Google T-shirt
title Google T-Shirt - Blue - Small
price 10.99 USD
availability in stock
color blue
size s
id 9876-S-BLU
item_group_id 9876
   
Product Google T-shirt
title Google T-Shirt - Yellow - Small
price 10.99 USD
availability out of stock
color yellow
size s
id 9876-S-YELLOW
item_group_id 9876
Was this article helpful?
How can we improve it?