PersonCard

Profile card for a person with avatar, name, role, and links, plus a skeleton loading state for rosters.

Status: beta. Group: structure. Markdown version: /design-system/components/person-card.md

When to use

Profile card for people: avatar, name, role, and links, with a skeleton state for loading rosters. Team and about-page module.

When not to use

The contract records no forbidden uses.

Look-alikes

The contract names no look-alike with a deciding condition.

Props

PersonCard props
Prop	Type	Default	Description	Required
`imageSrc`	`string`	none	No description in the contract.	Yes
`imageAlt`	`string`	none	No description in the contract.	Yes
`imageSrcSet`	`string`	none	No description in the contract.	No
`imageSizes`	`string`	none	No description in the contract.	No
`name`	`string`	none	No description in the contract.	Yes
`title`	`string`	none	No description in the contract.	Yes
`email`	`string`	none	No description in the contract.	Yes
`linkedinUrl`	`string`	none	No description in the contract.	No
`linkedinLabel`	`string`	none	No description in the contract.	No
`githubUrl`	`string`	none	No description in the contract.	No
`githubLabel`	`string`	none	No description in the contract.	No
`facebookUrl`	`string`	none	No description in the contract.	No
`facebookLabel`	`string`	none	No description in the contract.	No
`twitterUrl`	`string`	none	No description in the contract.	No
`twitterLabel`	`string`	none	No description in the contract.	No
`dribbbleUrl`	`string`	none	No description in the contract.	No
`dribbbleLabel`	`string`	none	No description in the contract.	No
`mediumUrl`	`string`	none	No description in the contract.	No
`mediumLabel`	`string`	none	No description in the contract.	No
`instagramUrl`	`string`	none	No description in the contract.	No
`instagramLabel`	`string`	none	No description in the contract.	No
`substackUrl`	`string`	none	No description in the contract.	No
`substackLabel`	`string`	none	No description in the contract.	No
`className`	`string`	none	No description in the contract.	No
`imageLoading`	`"lazy" \| "eager"`	`lazy`	No description in the contract.	No
`imageDecoding`	`"auto" \| "sync" \| "async"`	`async`	No description in the contract.	No
`loading`	`boolean`	`false`	Show skeleton placeholders while content is loading.	No

Variants

Allowed imageLoading values: lazy, eager (default lazy).
Allowed imageDecoding values: auto, sync, async (default async).

Invalid combinations

The contract records no invalid combinations.

Keyboard

The contract records no keyboard interaction.

Rules

Every item under When not to use is a MUST NOT. MUST and SHOULD follow RFC 2119.

PersonCard rules
Level	Rule	How it is checked
MUST	Required stories produce no axe violations at the configured severity.	Automated by `npm run test:stories:matrix:ci`. WCAG 2.5.8.
MUST	The accessibility tree (role, name, state) matches the committed snapshot for every required story.	Automated by `npm run test:stories:matrix:ci`. WCAG 1.3.1, 4.1.2.
MUST	The component remains legible and operable under a real browser forced-colors: active pass.	Automated by `npm run test:stories:hc`.
MUST	A human completed an end-to-end accessibility review of this component.	Manual review, last on 2026-05-28.
MUST NOT	Maintainers: Do not bypass design tokens or skip forced-colors verification at beta.	Release review; not machine-checked.

Install and import

In-repo only. PersonCard is not exported from @digitaltableteur/react, so there is no public import path.