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
description

Text, required

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

image

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": [
    "https://example.com/photos/1x1/photo.jpg",
    "https://example.com/photos/4x3/photo.jpg",
    "https://example.com/photos/16x9/photo.jpg"
   ]
name

Text, required

Artist or album name.

potentialAction

ListenAction, required

Music action(s). See Markup for Actions.

sameAs

URL, recommended

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

url

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.

Properties
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.

target

EntryPoint, required

A container for the action target.

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.
target.urlTemplate

URL, required

Deep link(s) to content.

Send feedback about...