This is the documentation for Recommendations AI, Retail Search, and the new Retail console.

Release notes

This page documents production updates to Retail. Check this page for announcements about new or updated features, bug fixes, known issues, and deprecated functionality.

You can see the latest product updates for all of Google Cloud on the Google Cloud page, browse and filter all release notes in the Google Cloud console, or you can programmatically access release notes in BigQuery.

To get the latest product updates delivered to you, add the URL of this page to your feed reader, or add the feed URL directly: https://cloud.google.com/feeds/retail-release-notes.xml

August 03, 2022

Serving controls can now be imported from and exported to files. This allows you to move serving controls between projects and do bulk edits and additions of serving controls within a project. This feature is available in Preview.

See the new documentation:

April 05, 2022

Retail Search is generally available.

For available features, see Features and capabilities.

For an overview of the steps to take to implement Retail Search, see Implementing the Retail API. To begin setting up Retail Search, go to Before you begin.

There are new data use terms for access and use of customer data for Recommendations AI and Retail Search. To view them, go to Terms for data use.

The new terms will be rolled out to Cloud Console from April 4 to 8, 2022. You will be required to accept these terms within 90 days to continue using Retail solutions uninterrupted.

To accept the data use terms:

  1. Access the Cloud Console and select your projects using Recommendations AI and/or Retail Search.
  2. The data use terms will appear on this page. If you wish to continue using our Retail solutions, please accept the terms for all projects using Recommendations AI and/or Retail Search.

If you wish to reject the terms, please disable all projects using the Cloud Retail API (Recommendations AI and Retail Search) in the Cloud Console.

We strongly encourage you to accept the terms before July 13, 2022. If you haven't accepted the terms by this date, you will lose API functionality.

For more details, please review our data use practices at Retail API data use.

January 21, 2022

The Retail console is now available to all Recommendations AI users. The Retail Console is a new way to manage both Recommendations AI and Retail Search seamlessly in one project through a unified onboarding and admin console experience.

We recommend switching to the Retail console and using the Retail documentation, which documents Recommendations AI, the Retail console, and Retail Search.

To switch, go to the new console and click Enable the Retail API. You can then view and manage your project from the new console.

January 15, 2021

Recommendations AI is now generally available.

This product has migrated to the Retail API from the Recommendations Engine API.

The previous API (service endpoint https://recommendationengine.googleapis.com) and its documentation set remain available, but they will no longer be updated. If you used the previous API while it was in beta, we recommend migrating your recommendations to the Retail API (service endpoint https://retail.googleapis.com).

See the new documentation: