---
title: "Person Schema · Unhead"
canonical_url: "https://unhead.unjs.io/docs/nuxt/schema-org/api/schema/person"
last_updated: "2026-07-21T16:53:13.900Z"
meta:
  description: "Use definePerson() to add Person structured data. Establish author identity for articles and content with name, image, and social profile links."
  "og:description": "Use definePerson() to add Person structured data. Establish author identity for articles and content with name, image, and social profile links."
  "og:title": "Person Schema · Unhead"
---

Home

`
Unhead on GitHub

Switch to NuxtSwitch to TypeScriptSwitch to VueSwitch to ReactSwitch to SvelteSwitch to Solid.jsSwitch to Angular

**Schema**

# **Person Schema**

[Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/person.md)

## Schema.org Person

- **Type**: `definePerson<T extends Record<string, any>>(input?: Person & T)`
  Describes an individual person. It is most commonly used to identify the author of a piece of content, such as an Article or Comment.

## Useful Links

- [**~~Schema.org Person~~**](https://schema.org/Person)
- [**~~Choose an Identity - Person~~**](https://unhead.unjs.io/docs/schema-org/guides/recipes/identity#person)

## Required properties

- **name** `**string**`
  The name of the person.

## Recommended Properties

- **image** `**NodeRelations<ImageObject | string>**`
  The URL of the person's avatar image.
- **url** `**string**` or **sameAs** `**Arrayable<string>**`
  Links that describe the person, for example their website or social accounts.

## Examples

### Minimal

```
definePerson({
  name: 'Harlan Wilton',
  image: '/me.png',
})
```

## Defaults

- **@type**: `**Person**`
- **@id**: `**${canonicalHost}#identity**`
- **url**: `**canonicalHost**`

## Resolves

See [**~~Global Resolves~~**](https://unhead.unjs.io/docs/schema-org/guides/get-started/overview#how-does-schemaorg-get-page-data) for full context.

- resolves relative string URLs in `**image**`
- when `**@id**` is omitted, uses the primary `**#identity**` ID and links the Person as the WebSite publisher and default Article author when those nodes exist

## Types

```
/**
 * A person (alive, dead, undead, or fictional).
 */
export interface PersonSimple extends Thing {
  /**
   * The full name of the Person.
   */
  name: string
  /**
   * The user bio.
   */
  description?: string
  /**
   * An array of URLs representing declared social/authoritative profiles of the person
   * (e.g., a Wikipedia page, or Facebook profile).
   */
  sameAs?: Arrayable<string>
  /**
   * An array of images which represent the person, referenced by ID.
   */
  image?: NodeRelations<ImageObject | string>
  /**
   * The URL of the user's profile page (if they're affiliated with the site in question),
   * or to their personal homepage/website.
   */
  url?: string
}
```

## Related Schemas

- [**~~Organization~~**](https://unhead.unjs.io/docs/schema-org/api/schema/organization): Person's employer
- [**~~Article~~**](https://unhead.unjs.io/docs/schema-org/api/schema/article): Articles by person

[~~Edit this page~~](https://github.com/unjs/unhead/edit/main/docs/schema-org/5.api/9.schema/person.md)

[~~Markdown For LLMs~~](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/person.md)

**Did this page help you? **

[**Organization** Add Organization structured data with Unhead. Describe a company identity, logo, address, contact details, and sameAs profiles.](https://unhead.unjs.io/docs/schema-org/api/schema/organization) [**Podcast Episode Schema** Use definePodcastEpisode() to describe a podcast episode, including its title, audio, dates, duration, transcript, and parent series.](https://unhead.unjs.io/docs/schema-org/api/schema/podcast-episode)

**On this page **

- [Schema.org Person](#schemaorg-person)
- [Useful Links](#useful-links)
- [Required properties](#required-properties)
- [Recommended Properties](#recommended-properties)
- [Examples](#examples)
- [Defaults](#defaults)
- [Resolves](#resolves)
- [Types](#types)
- [Related Schemas](#related-schemas)