XooCode(){

PlayAction

PlayAction is an Action subtype for performing or participating in entertainment or recreational activities: playing music, performing on stage, exercising, playing a game. Direct subtypes are PerformAction (music, theatre) and ExerciseAction (sports, fitness). It adds two properties: audience (the audience present) and event (the event it takes place at).

PlayAction is distinct from ConsumeAction: PlayAction is the performer-side verb, ConsumeAction / WatchAction is the audience-side. A concert has a PerformAction (by the musician) and many WatchActions (by attendees).

Full example of schema.org/PlayAction json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional
schema.org/PlayAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "PerformAction",
  "name": "Performed at Oslo Nordic Winter Concert 2026",
  "agent": { "@type": "Person", "name": "Nora Lindgren" },
  "event": { "@type": "MusicEvent", "name": "Oslo Nordic Winter Concert 2026", "startDate": "2026-11-18T20:00:00+01:00", "location": { "@type": "Place", "name": "Oslo Konserthus" } },
  "startTime": "2026-11-18T20:00:00+01:00",
  "endTime": "2026-11-18T22:15:00+01:00",
  "actionStatus": "https://schema.org/CompletedActionStatus"
}
</script>

Minimal valid version

The smallest markup that still produces a valid PlayAction entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/PlayAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "PerformAction",
  "agent": { "@type": "Person", "name": "Nora Lindgren" },
  "event": { "@type": "MusicEvent", "name": "Oslo Nordic Winter Concert 2026" }
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

Common PlayAction mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    PlayAction for the audience of a performance

    Wrong
    PerformAction listing audience members as agent
    Right
    Agent of PerformAction is the performer; audience consumption is WatchAction/ListenAction

    PerformAction is performer-side. A spectator at the same concert would emit a WatchAction or ListenAction, not a PerformAction with themselves as agent.

Schema properties in this example

PlayActionPerformActionActionnameagentPersoneventMusicEventstartDatelocationPlacestartTimeendTimeactionStatusCompletedActionStatusaudience

About the example data

Nora Lindgren performing at the Oslo concert she travels to in the BoatTrip example.

Comments

Loading comments...

Leave a comment