Note: you are viewing the webschemas.org development version of schema.org. See How we work for more details.
core + bib (Bibliographic Extension): terms relating to books and bibliography.

Action

Canonical URL: http://schema.org/Action

An action performed by a direct agent and indirect participants upon a direct object. Optionally happens at a location with the help of an inanimate instrument. The execution of the action may produce a result. Specific action sub-type documentation specifies the exact expectation of each argument/role.

See also blog post and Actions overview document.


Usage: Between 100 and 1000 domains

Acknowledgement

The schema.org Actions mechanism benefited from extensive discussions across the Web standards community around W3C, in particular from the Hydra project's community group.



Examples

Example 1
John listened to Pink with Steve at Anna's apartment on his iPod.
This example is JSON only.
This example is JSON only.
<!--  John listened to Pink with Steve at Anna's apartment on his iPod. -->
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "ListenAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "MusicGroup",
    "name": "Pink!"
  },
  "participant": {
    "@type": "Person",
    "name": "Steve"
  },
  "location": {
    "@type": "Residence",
    "name": "Ann's apartment"
  },
  "instrument": {
    "@type": "Product",
    "name": "iPod"
  }
}
</script>
Example 2
John created an exercise plan with Steve.
This example is JSON only.
This example is JSON only.
<!--  John created an exercise plan with Steve. -->
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "CreateAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "result": {
    "@type": "ExercisePlan",
    "name": "John's weight loss plan"
  },
  "participant": {
    "@type": "Person",
    "name": "Steve"
  }
}
</script>

Schema Version 3.3