Music actions make Google Search an entry point for discovering and listening to music artists and their songs. Music actions can appear in Google properties such as Knowledge Graph cards, enabling users to listen to songs from streaming services.

When a user searches for the name of an artist on Google or on their mobile device, a Knowledge Graph card may appear prominently in the Search results. Music actions in the card will use deep links to partner apps or web landing pages, bringing users directly from the Knowledge Graph card to the specific artist.


Example 1: Music Artist

Example 2: Music Album


For a streamlined user experience, your content should immediately start playing when the user clicks, rather than directing the user to a landing page that requires more clicks to start playback.

Type Definitions

Markup for artists and albums

Each music artist and music album should be defined respectively in a MusicGroup or MusicAlbum item with the following properties.


Text, required

A biography of the artist or a description of the album.


Repeated field of ImageObject or URL, recommended

URL of an image of the artist or album.

Additional image guidelines:

  • Every page must contain at least one image (whether or not you include markup). Google will pick the best image to display in Search results based on the aspect ratio and resolution.
  • Image URLs must be crawlable and indexable.
  • Images must represent the marked up content.
  • Images must be in .jpg, .png, or. gif format.
  • For best results, provide multiple high-resolution images (minimum of 50K pixels when multiplying width and height) with the following aspect ratios: 16x9, 4x3, and 1x1.

For example:

"image": [

Text, required

Artist or album name.


ListenAction, required

Music action(s). See Markup for Actions.


URL, recommended

URL of a page that unambiguously identifies the artist or album. Example: Wikipedia.


URL, required

URL of the landing page of the artist or album on the partner site.

Markup for actions

The following properties are required for each ListenAction.


Offer, required

A container for the action conditions.


Country, required

Countries in which the action is available.

Text, required

The ISO 3166 country code.


EntryPoint, required

A container for the action target.


Text, required

The platform(s) on which the deep link works. One or more of the following:

  • Works on desktop web browsers.
  • Works on mobile web browsers.
  • Works on Android native app.
  • Works on iOS native app.

URL, required

Deep link(s) to content.

Enviar comentários sobre…