XooCode(){

AchieveAction

AchieveAction is an Action subtype for actions with an accomplishment as their result: winning a competition, completing a certification, unlocking an achievement, earning a badge. Direct subtypes are WinAction, LoseAction, and TieAction. It adds no properties of its own; the accomplishment is carried on result (inherited from Action).

AchieveAction is most common in gamified and certification contexts: learning platforms, esports, fitness apps. For a sport-event result (a team winning a game), prefer homeTeam/awayTeam/winner on SportsEvent.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/AchieveAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "AchieveAction",
  "name": "Earned XooStructured Schema Architect certification",
  "agent": { "@type": "Person", "name": "Lena Vasquez" },
  "startTime": "2026-02-11T09:00:00-05:00",
  "endTime": "2026-02-11T11:48:00-05:00",
  "actionStatus": "https://schema.org/CompletedActionStatus",
  "result": { "@type": "EducationalOccupationalCredential", "name": "XooStructured Schema Architect", "credentialCategory": "certification" }
}
</script>

Minimal valid version

The smallest markup that still produces a valid AchieveAction 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/AchieveAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "AchieveAction",
  "agent": { "@type": "Person", "name": "Lena Vasquez" },
  "result": { "@type": "EducationalOccupationalCredential", "name": "Schema Architect certification" }
}
</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.

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

    Using AchieveAction for sport match outcomes

    Wrong
    AchieveAction in place of marking a SportsEvent with homeTeam/awayTeam/winner
    Right
    Use SportsEvent with homeTeam, awayTeam, and winner; reserve AchieveAction for individual accomplishments (certifications, badges, records)

    Google's event and match markup already expresses win/loss via SportsEvent fields. AchieveAction is more useful for personal achievements that don't fit the event model.

Schema properties in this example

AchieveActionActionnameagentPersonstartTimeendTimeactionStatusCompletedActionStatusresultEducationalOccupationalCredentialcredentialCategory

About the example data

Lena Vasquez earning the XooStructured "Schema Architect" certification after completing the Structured Data Fundamentals course.

Comments

Loading comments...

Leave a comment