XooCode(){

SubscribeAction

SubscribeAction is an Action subtype (via InteractAction) for subscribing to updates: newsletter signups, RSS subscriptions, notification opt-ins, podcast follows. It adds no properties of its own. Use it as a potentialAction on a WebSite, Organization, or CreativeWork to indicate a subscription option with a target URL pointing to the signup page.

SubscribeAction is not widely used in structured data yet and does not trigger a specific Google rich result. It is most useful for expressing subscription options in API contexts, email markup, and for AI systems that read structured data to understand what actions are available on a page.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/SubscribeAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Xoo Code Inc.",
  "@id": "https://xoocode.com#organization",
  "potentialAction": {
    "@type": "SubscribeAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://xoocode.com/newsletter/subscribe"
    },
    "object": {
      "@type": "CreativeWorkSeries",
      "name": "Xoo Code Newsletter",
      "description": "Weekly structured data tips, schema.org updates, and Xoo universe news."
    }
  }
}
</script>

Minimal valid version

The smallest markup that still produces a valid SubscribeAction 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/SubscribeAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "XooCode",
  "url": "https://xoocode.com",
  "potentialAction": {
    "@type": "SubscribeAction",
    "target": "https://xoocode.com/newsletter/subscribe"
  }
}
</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 SubscribeAction 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

    SubscribeAction without a target URL

    Wrong
    SubscribeAction with object but no target
    Right
    "target": { "@type": "EntryPoint", "urlTemplate": "https://xoocode.com/newsletter/subscribe" }

    Without a target, the action has no destination. The target URL is where the user goes to complete the subscription. It is the most important property on any Action.

Schema properties in this example

SubscribeActionInteractActionActionOrganizationpotentialActiontargetEntryPointurlTemplateobjectCreativeWorkSeries

About the example data

The Xoo Code newsletter subscription, embedded as a potentialAction on the Organization entity.

Comments

Loading comments...

Leave a comment