Music

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.

Examples

Example 1: Music Artist

Example 2: Music Album

Guidelines

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.

Properties
name

Text, required

Artist or album name.

description

Text, required

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

url

URL, required

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

image

URL, recommended

URL of an image of the artist or album.

sameAs

URL, recommended

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

potentialAction

ListenAction, required

Music action(s). See Markup for Actions.

Markup for actions

The following properties are required for each ListenAction.

Properties
target

EntryPoint, required

A container for the action target.

target.urlTemplate

URL, required

Deep link(s) to content.

target.actionPlatform

Text, required

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

  • http://schema.org/DesktopWebPlatform: Works on desktop web browsers.
  • http://schema.org/MobileWebPlatform: Works on mobile web browsers.
  • http://schema.org/AndroidPlatform: Works on Android native app.
  • http://schema.org/IOSPlatform: Works on iOS native app.
expectsAcceptanceOf

Offer, required

A container for the action conditions.

expectsAcceptanceOf.eligibleRegion

Country, required

Countries in which the action is available.

expectsAcceptanceOf.eligibleRegion.name

Text, required

The ISO 3166 country code.

Send feedback about...