PerformanceRole

PerformanceRole is a Role subtype for an actor's role in a performance. Property: characterName (Text). Used as a wrapper around Person in Movie/TVEpisode.actor.

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

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

schema.org/PerformanceRole

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Movie",
  "name": "Dunmore: The Archive",
  "actor": {
    "@type": "PerformanceRole",
    "characterName": "Jane Xoo",
    "actor": { "@type": "Person", "name": "Mette Kristensen" }
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid PerformanceRole 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/PerformanceRole (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "PerformanceRole",
  "characterName": "Example character",
  "actor": { "@type": "Person", "name": "Actor name" }
}
</script>

Google rich results this unlocks

PerformanceRole is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). PerformanceRole becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common PerformanceRole 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.

01
characterName on the Person node directly
Wrong
```
Person with characterName
```
Right
```
Wrap in PerformanceRole so the role is distinct from the person
```
The Role wrapper exists so one Person can hold multiple roles across different works.

Schema properties in this example

PerformanceRole Role characterName actor Movie Person

About the example data

Mette Kristensen as "Jane Xoo" in the Dunmore Archive documentary reenactment.

Comments

Loading comments...