XooCode(){

CreateAction

CreateAction is an Action subtype for creating something: writing, photographing, filming, drawing, painting, cooking. Direct subtypes are WriteAction, PhotographAction, DrawAction, FilmAction, CookAction, and PaintAction. The produced work lives on result (inherited from Action).

CreateAction pairs naturally with CreativeWork: the CreativeWork's author and dateCreated express the same information, so CreateAction is mostly useful in activity streams and editorial logs where the act of creation is itself the object of interest.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/CreateAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CreateAction",
  "name": "Wrote Why We Built XooTee",
  "agent": { "@type": "Person", "name": "Lena Vasquez", "url": "https://xoocode.com/team/lena-vasquez" },
  "startTime": "2026-01-06T09:00:00-05:00",
  "endTime": "2026-01-06T13:45:00-05:00",
  "actionStatus": "https://schema.org/CompletedActionStatus",
  "result": { "@type": "BlogPosting", "headline": "Why We Built XooTee", "url": "https://xoocode.com/blog/why-we-built-xootee" }
}
</script>

Minimal valid version

The smallest markup that still produces a valid CreateAction 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/CreateAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CreateAction",
  "agent": { "@type": "Person", "name": "Lena Vasquez" },
  "result": { "@type": "BlogPosting", "headline": "Why We Built XooTee" }
}
</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 CreativeWork's author/dateCreated)
    Google docs

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

    CreateAction duplicating CreativeWork author/date

    Wrong
    Emitting a CreateAction on every blog post in addition to BlogPosting.author and BlogPosting.dateCreated
    Right
    Use CreativeWork's author and dateCreated for page markup; reserve CreateAction for activity streams where the act of writing is the subject

    Google reads author and dateCreated directly off the CreativeWork. Adding a parallel CreateAction doubles the markup without adding information.

Schema properties in this example

CreateActionActionnameagentPersonurlstartTimeendTimeactionStatusCompletedActionStatusresultBlogPostingheadline

About the example data

Lena Vasquez writing the "Why We Built XooTee" blog post referenced in the BlogPosting example.

Comments

Loading comments...

Leave a comment