DigitalDocumentPermission

DigitalDocumentPermission is an Intangible describing access rights on a DigitalDocument. Properties: grantee (Person / Organization / Audience) and permissionType (DigitalDocumentPermissionType enum: ReadPermission, WritePermission, CommentPermission).

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

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

schema.org/DigitalDocumentPermission

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "DigitalDocumentPermission",
  "grantee": { "@type": "Person", "name": "Mette Kristensen" },
  "permissionType": "https://schema.org/WritePermission"
}
</script>

Minimal valid version

The smallest markup that still produces a valid DigitalDocumentPermission 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/DigitalDocumentPermission (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "DigitalDocumentPermission",
  "grantee": { "@type": "Person", "name": "Example user" },
  "permissionType": "https://schema.org/ReadPermission"
}
</script>

Google rich results this unlocks

DigitalDocumentPermission 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). DigitalDocumentPermission becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common DigitalDocumentPermission 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.

permissionType as free text

Wrong

"permissionType": "read"

Right

"permissionType": "https://schema.org/ReadPermission"

Three-URI enum closed set.

Schema properties in this example

DigitalDocumentPermission Intangible grantee Person permissionType ReadPermission WritePermission CommentPermission

Also mentioned in 3 other examples

DigitalDocumentPermission also appears in DigitalDocument, DigitalDocumentPermissionType, and NoteDigitalDocument. See the full DigitalDocumentPermission schema page for every reference.

About the example data

Write permission on the Dunmore Archive's editorial wiki for Jane Xoo's grand-daughter.

Comments

Loading comments...