ChooseAction

ChooseAction is an AssessAction subtype for selecting among options. Properties: option / actionOption (Thing or Text — the choices). Parent of VoteAction.

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

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

schema.org/ChooseAction

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ChooseAction",
  "agent": { "@type": "Person", "name": "Mette Kristensen" },
  "option": [
    { "@type": "Person", "name": "Candidate A" },
    { "@type": "Person", "name": "Candidate B" }
  ],
  "result": { "@type": "Person", "name": "Candidate A" }
}
</script>

Minimal valid version

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ChooseAction",
  "agent": { "@type": "Person", "name": "Chooser" },
  "option": ["Option A", "Option B"]
}
</script>

Google rich results this unlocks

ChooseAction 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). ChooseAction becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common ChooseAction 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
Bare ChooseAction where VoteAction fits
Wrong
```
ChooseAction on a political vote
```
Right
```
VoteAction for elections
```
Use the specific subtype when one applies.

Schema properties in this example

ChooseAction AssessAction Action agent Person option actionOption result

Also mentioned in 1 other example

ChooseAction also appears in VoteAction. See the full ChooseAction schema page for every reference.

About the example data

Choosing the Dunmore Foundation's 2026 fellowship recipient.

Comments

Loading comments...