In this help center, you can find content for both Merchant Center Next and the classic Merchant Center experience. Look for the logo at the top of each article to make sure you're using the article for the Merchant Center version that applies to you. 

Disclosure date [disclosure_date]

A custom icon for Merchant Center Classic Article Header.

Use the disclosure date [disclosure_date] attribute to tell Google when a product should become visible in search results across Google’s YouTube surfaces only.

In this page

When to use

Optional for each product.

Recommended for launching a new product on YouTube.

If there is no disclosure date specified, the product may begin serving on Google and YouTube surfaces immediately.


Follow these formatting guidelines to make sure Google understands the data you're submitting.

Note: Use the same timezone as the one set in Merchant Center to avoid products becoming visible at an incorrect time. If the timezone isn't specified, UTC timezone will be used.

For details on when and how to submit values in English, learn more about submitting your product data.


Date, time, and timezone, ISO 8601 compliant

(YYYY-MM-DDThh:mm[±hhmm], or YYYY-MM-DDThh:mmZ)

Limits 1–25 characters

Repeated field


File format Example value
Text (TSV) 2016-12-25T13:00-0800
XML (Feeds) <g:disclosure_date>2016-11-25T13:00-0800</g:disclosure_date>

To format your data for Content API, see the Content API for Shopping.

Note: To ensure that this product data attribute gets recognized by our system correctly, remember to submit your data feed file in a format that we support.


Follow these guidelines to make sure you submit high-quality data for your products.

Minimum requirements

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

Best practices

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

  • If you’re using the disclosure date to launch a new product on a YouTube live stream, review tips for live shopping on YouTube.
  • Make sure you update the product data including the disclosure date [disclosure date] at least one week before the launch date submitted to Google. This ensures that Google doesn’t publish your product information before the specified date.
  • Verify the date and time format along with your timezone (considering daylight savings) in Merchant Center to avoid issues with product visibility.
  • Make sure the landing page URL is available for customers, by making it listed and searchable, before the disclosure date. If not, customers will see an error message.
  • After the disclosure date has passed, remove the attribute within 24 hours to avoid any serving issues.


Unavailable for Shopping ads & free listings

An offer with a disclosure date [disclosure_date] attribute can’t be selected for Shopping ads nor free listings. If you would like to run a Shopping campaign or have your product appear across Google free listings surfaces, remove the disclosure date [disclosure_date] attribute immediately after the disclosure date has passed. It may take up to 40 hours after the removal for the Shopping campaign to start again or for the product to appear on Google’s free listings surfaces.

Troubleshooting: If you have Shopping ads running alongside an offer with disclosure date, you may see the warning “Too many values [disclosure_date]” in the “Diagnostics” page. Ignore the warning as it means that the product is correctly set up and not being used for Shopping ads.

Shopify merchants

In addition to the above guidelines, follow the ones listed below.

  • Use the Shopify app on desktop only
  • The disclosure date [disclosure_date] attribute doesn’t exist in the Shopify app. In order to schedule the launch date and time for your product:
    1. Go to the product drop page under the “Sales channels and apps” box.
    2. Select Schedule availability for the online store and add the date and time (+timezone).
    3. Select Schedule availability for Google and add the same date and time (+timezone).
  • Shopify automatically removes the disclosure date attribute in Merchant Center at the time of the disclosure date so there is no need to manually remove it.

Was this helpful?

How can we improve it?
Clear search
Close search
Google apps
Main menu