XooCode(){

ConsumeAction

ConsumeAction is an Action subtype for consuming content or products: reading, watching, listening, using, installing, eating, drinking. It is the direct parent of ViewAction, WatchAction, ReadAction, ListenAction, UseAction, EatAction, DrinkAction, and InstallAction. It exposes two important properties: actionAccessibilityRequirement (for paywall or subscription gating) and expectsAcceptanceOf (for licensing or ToS acceptance).

Most production markup skips the parent ConsumeAction and reaches for the relevant subtype directly. Use bare ConsumeAction only when the verb is unusual enough that no subtype fits.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/ConsumeAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ConsumeAction",
  "agent": { "@type": "Person", "name": "Reader" },
  "object": { "@type": "ScholarlyArticle", "headline": "Pediatric Care in Post-War Denmark: A Clinical Framework" },
  "target": { "@type": "EntryPoint", "urlTemplate": "https://roydanmedjournal.dk/archive/1945/pediatric-care-post-war-denmark", "actionPlatform": ["https://schema.org/DesktopWebPlatform", "https://schema.org/MobileWebPlatform"] },
  "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "requiresSubscription": { "@type": "MediaSubscription", "name": "RDMJ Archive Access" } }
}
</script>

Minimal valid version

The smallest markup that still produces a valid ConsumeAction 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/ConsumeAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ConsumeAction",
  "agent": { "@type": "Person", "name": "Reader" },
  "object": { "@type": "Article", "headline": "Example article" }
}
</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.

  • No dedicated rich result (use ViewAction / WatchAction / ReadAction)
    Google docs

Common ConsumeAction 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

    Bare ConsumeAction instead of a subtype

    Wrong
    "@type": "ConsumeAction" on a video
    Right
    "@type": "WatchAction" for videos, "ReadAction" for articles, "ListenAction" for audio

    Rich result eligibility lives on the subtypes. A bare ConsumeAction earns no rich result and communicates little beyond the accessibility requirement.

Schema properties in this example

ConsumeActionActionagentPersonobjectScholarlyArticletargetEntryPointurlTemplateactionPlatformactionAccessibilityRequirementActionAccessSpecificationrequiresSubscriptionMediaSubscriptionexpectsAcceptanceOf

About the example data

Reading the 1945 Jane Xoo paper on a subscription-gated Royal Danish Medical Journal archive page.

Comments

Loading comments...

Leave a comment