PlanAction

PlanAction is an OrganizeAction subtype for planning. Property: scheduledTime (DateTime).

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

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

schema.org/PlanAction

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "PlanAction",
  "agent": { "@type": "Organization", "name": "Dunmore Archive" },
  "scheduledTime": "2026-04-23T19:00:00+02:00",
  "result": { "@type": "Event", "name": "1945 Anniversary Dinner" }
}
</script>

Minimal valid version

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "PlanAction",
  "scheduledTime": "2026-04-23T19:00:00+02:00"
}
</script>

Google rich results this unlocks

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

Common PlanAction 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
scheduledTime as a date without timezone
Wrong
```
"scheduledTime": "2026-04-23"
```
Right
```
Full ISO 8601 datetime with offset
```
Plans span timezones; the offset disambiguates.

Schema properties in this example

PlanAction OrganizeAction Action agent scheduledTime result Event

Also mentioned in 3 other examples

PlanAction also appears in CancelAction, ReserveAction, and ScheduleAction. See the full PlanAction schema page for every reference.

About the example data

Planning the Dunmore Archive's 2026 anniversary dinner.

Comments

Loading comments...