XooCode(){

TransferAction

TransferAction is an Action subtype for moving something from one party to another: downloading, sending, giving, lending, borrowing, returning, transferring money. Direct subtypes are DownloadAction, SendAction, ReceiveAction, GiveAction, TakeAction, BorrowAction, LendAction, ReturnAction, and MoneyTransfer. It adds the same fromLocation/toLocation pair as MoveAction.

DownloadAction is the most common web-facing subtype, used as a potentialAction on a DigitalDocument or SoftwareApplication to declare the download URL.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/TransferAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "DownloadAction",
  "name": "Downloaded ROI of Structured Data whitepaper",
  "agent": { "@type": "Person", "name": "Reader" },
  "object": { "@type": "DigitalDocument", "name": "The ROI of Structured Data: 2026 Benchmark Report", "url": "https://xoocode.com/resources/roi-of-structured-data" },
  "target": { "@type": "EntryPoint", "urlTemplate": "https://xoocode.com/resources/roi-of-structured-data/download.pdf" },
  "actionStatus": "https://schema.org/CompletedActionStatus"
}
</script>

Minimal valid version

The smallest markup that still produces a valid TransferAction 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/TransferAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "DownloadAction",
  "agent": { "@type": "Person", "name": "Reader" },
  "object": { "@type": "DigitalDocument", "name": "ROI of Structured Data whitepaper" },
  "target": "https://xoocode.com/resources/roi-of-structured-data/download.pdf"
}
</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 TransferAction 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

    DownloadAction target pointing to the landing page

    Wrong
    "target": "https://example.com/whitepapers/roi" (the informational page)
    Right
    "target": "https://example.com/whitepapers/roi/download.pdf" (the actual file)

    DownloadAction.target should be the direct file URL. Pointing it at the landing page defeats the purpose and misleads consumers expecting a binary stream.

Schema properties in this example

TransferActionDownloadActionActionnameagentPersonobjectDigitalDocumenturltargetEntryPointurlTemplateactionStatusCompletedActionStatusfromLocationtoLocation

About the example data

Downloading the Xoo Code "ROI of Structured Data" whitepaper, the document represented by the DigitalDocument example.

Comments

Loading comments...

Leave a comment