XooCode(){

Permit

Permit is a direct Intangible for any kind of authorised permission: food-service permits, building permits, alcohol licences, event permits, permits for professional practice. It is the parent of GovernmentPermit.

It adds 7 direct properties:

  • issuedBy (Organization): the authority that granted the permit.
  • issuedThrough (Service): the service through which the permit was issued (often a GovernmentService page).
  • permitAudience (Audience): who the permit is for (a business type, an individual occupation).
  • validFor (Duration): how long the permit is valid — an ISO 8601 duration (P1Y).
  • validFrom (Date or DateTime): when the permit becomes valid.
  • validUntil (Date): when it expires.
  • validIn (AdministrativeArea): geographic scope.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/Permit
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Permit",
  "@id": "https://dunmoregrill.example/permits/liquor",
  "name": "Retail Dispenser Eating Place Liquor Licence",
  "description": "Retail liquor licence authorising the sale of malt, brewed, and distilled beverages for on-premises consumption with food.",
  "issuedBy": { "@type": "GovernmentOrganization", "name": "Pennsylvania Liquor Control Board" },
  "issuedThrough": { "@type": "GovernmentService", "name": "PLCB Licensing" },
  "permitAudience": { "@type": "Audience", "audienceType": "Eating places (Pennsylvania)" },
  "validFor": "P1Y",
  "validFrom": "2026-01-15",
  "validUntil": "2027-01-14",
  "validIn": { "@type": "State", "name": "Pennsylvania", "identifier": "US-PA" },
  "identifier": [
    { "@type": "PropertyValue", "propertyID": "PLCB-LID", "value": "R-1234567" }
  ]
}
</script>

Where Permit fits

On a business's credential listing (hasCredential), on a Person's professional-licence listing, or standalone on a "how to get a [permit]" page where the Permit entity is the subject and the Service / Organization that issues it is linked via issuedBy and issuedThrough.

Minimal valid version

The smallest markup that still produces a valid Permit 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/Permit (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Permit",
  "name": "Retail Liquor Licence",
  "issuedBy": { "@type": "GovernmentOrganization", "name": "Pennsylvania Liquor Control Board" },
  "validFrom": "2026-01-15",
  "validUntil": "2027-01-14"
}
</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.

  • No dedicated rich result (used by business-credential and licensing knowledge graphs)
    Google docs

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

    validFor as a plain number

    Wrong
    "validFor": 365
    Right
    "validFor": "P1Y" (ISO 8601 duration)

    validFor expects ISO 8601 duration syntax; plain numbers have no time unit.

  2. 02

    Free text instead of issuedBy

    Wrong
    "issuedBy": "Liquor Control Board"
    Right
    Typed GovernmentOrganization object with name and ideally @id

    Entity-resolved issuer references collapse cleanly into licensing knowledge graphs.

  3. 03

    Missing validIn for region-specific permits

    Wrong
    A state liquor licence with no validIn signal
    Right
    validIn: State or Country node scoping the permit

    Licences are almost always jurisdiction-scoped. Without validIn, consumers cannot tell where the permit actually applies.

Schema properties in this example

PermitIntangiblenamedescriptionissuedByGovernmentOrganizationissuedThroughGovernmentServicepermitAudienceAudienceaudienceTypevalidForvalidFromvalidUntilvalidInStateidentifierPropertyValuepropertyIDvalueGovernmentPermit

Also mentioned in 1 other example

Permit also appears in GovernmentPermit. See the full Permit schema page for every reference.

About the example data

A fictional Liquor Licence issued by the Pennsylvania Liquor Control Board, held by The Dunmore Grill.

Comments

Loading comments...

Leave a comment