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

Artist or album name.


Text, required

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


URL, required

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


URL, recommended

URL of an image of the artist or album.


URL, recommended

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


ListenAction, required

Music action(s). See Markup for Actions.

Markup for actions

The following properties are required for each ListenAction.


EntryPoint, required

A container for the action target.


URL, required

Deep link(s) to content.


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.

Offer, required

A container for the action conditions.


Country, required

Countries in which the action is available.

Text, required

The ISO 3166 country code.

Send feedback about...