XooCode(){

InsertAction

InsertAction is an AddAction subtype for inserting something into a specific location. Property: toLocation (Place).

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

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

schema.org/InsertAction
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "InsertAction",
  "object": { "@type": "ScholarlyArticle", "headline": "Pediatric Care in Post-War Denmark" },
  "toLocation": { "@type": "Place", "name": "Dunmore Archive — Shelf C7" }
}
</script>

Minimal valid version

The smallest markup that still produces a valid InsertAction 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/InsertAction (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "InsertAction",
  "toLocation": { "@type": "Place", "name": "Destination" }
}
</script>

Google rich results this unlocks

InsertAction is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). InsertAction becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

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

    Missing toLocation

    Wrong
    InsertAction with only object
    Right
    Always include toLocation — that's the verb's defining field

    Insert without destination is just Add.

Schema properties in this example

InsertActionAddActionActionobjectScholarlyArticletoLocationPlace

Also mentioned in 2 other examples

InsertAction also appears in AppendAction, and PrependAction. See the full InsertAction schema page for every reference.

About the example data

Adding Jane Xoo's 1945 paper to the Dunmore Archive catalogue.

Comments

Loading comments...

Leave a comment