Notification

In this Help Centre, 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 that 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.

Format

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

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

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

Type

Date, time and time zone, ISO 8601 compliant

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

Limits 1–25 characters

Repeated field

No

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 the Content API, take a look at the Content API for Shopping.

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

Guidelines

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

Minimum requirements

These are the requirements that 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 on the Diagnostics page in your Merchant Center account.

Best practices

These best practices can help you to go beyond the basic requirements to optimise 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 that 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 time zone (considering daylight savings) in Merchant Center to avoid issues with product visibility.
  • Make sure that 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.

Limitations

Unavailable for Shopping ads and free listings

An offer with a disclosure date [disclosure_date] attribute can't be selected for Shopping ads or 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 a disclosure date, you may see the warning 'Too many values [disclosure_date]' on the 'Diagnostics' page. Ignore the warning as it means that the product is correctly set up and not being used for Shopping ads.

Product variants with Buy on Google [US only]

It isn't recommended to set a disclosure date [disclosure_date] attribute if your products have Buy on Google checkout with multiple product variants (products with a variety of sizes or colours). Setting a disclosure date [disclosure_date] attribute displays all the variants as separate products and prevents customers from picking other variants of the product on Google or YouTube. If you wish to use Buy on Google checkout with disclosure date, we recommend adjusting the product title [title] to highlight the differences. For example, you might want to title your '80s vintage crew neck' as 'Blue 80s vintage crew neck – Medium'.

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 shop and add the date and time (+ time zone).
    3. Select Schedule availability for Google and add the same date and time (+ time zone).
  • 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?
true
Search
Clear search
Close search
Google apps
Main menu