---
title: Examples
slug: wip/QAwz-examples
createdAt: 2023-07-20T14:45:03.180Z
---

# Examples

## Basic Usage

The Person Item only needs a minimal amount of provided data to be used. It requires at a minimum that the name field is provided.

:::Iframe{iframeHeight="0" code="<iframe title=&#x22;Embeded content from codepen.io&#x22; class=&#x22;no-border max-full-width full-height flex-grow&#x22; src=&#x22;https://codepen.io/redbulldesign/embed/zYMBWZB/db0e65688828aa171b3eaf471dbbad6c?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;244px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

**Best Practices:**

- The `name` should only be used for a person's full name or nickname
- The `name` should use [title-case](https://en.wikipedia.org/wiki/Letter_case#Title_case)
- The `name` should not include emojis
- The `profile-image` should show a portrait of the person
- The `profile-image` should be a square (1:1 aspect ratio) image.
- The `profile-image` should not display a partially cropped head.
- For optimal quality on high-resolution displays, the `profile-image` should be 280px in dimension.

## Extended Usage

:::Iframe{iframeHeight="0" code="<iframe title=&#x22;Embeded content from codepen.io&#x22; class=&#x22;no-border max-full-width full-height flex-grow&#x22; src=&#x22;https://codepen.io/redbulldesign/embed/JjeKLZy/4dcef144a15b8f52547364dedce3e94e?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

**Best Practices:**

- All meta information should be kept short and scannable, as each item is truncated to a single line of text.
- `meta-text-primary `above the name should be used for high-priority or standout details.
- `meta-text-secondary` and `additional-info` can be used on their own if more appropriate to provide further context; however, `additional-info` should only be used if `meta-text-secondary` is true.
- For visual support, each piece of meta information can have a prefix in which, for example, an icon or flag can be used.&#x20;
- Redirects to `external` links (e.g. an athletes social media profile) should open in a new tab.

## Size

The size of the Person Item can be controlled via the `size` property.

:::Iframe{iframeHeight="0" code="<iframe title=&#x22;Embeded content from codepen.io&#x22; class=&#x22;no-border max-full-width full-height flex-grow&#x22; src=&#x22;https://codepen.io/redbulldesign/embed/MWzeXLR/b20f425edbd8bc04c52c6d200b55c017?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

**Best Practices:**

- Use the 'small' `size` when you want to create a more condensed layout where multiple items are displayed in a list or a rail.
- Use the 'medium' `size` when there is greater space available to show only a single Person Item.

## Image Fallback

As per the functionality of the [Avatar](https://cosmos.redbull.design/wip/avatar), the Person Item generates a fallback based on the initials of the first and last name of the person.

:::Iframe{iframeHeight="0" code="<iframe title=&#x22;Embeded content from codepen.io&#x22; class=&#x22;no-border max-full-width full-height flex-grow&#x22; src=&#x22;https://codepen.io/redbulldesign/embed/JjeKBdR/375e5fb815b61ad71d4f03a0a09a63c6?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

## Number

Essential for displaying player identifiers in Person Items, especially important in sports where the `number` is strongly associated with athletes.

:::Iframe{iframeHeight="0" code="<iframe title=&#x22;Embeded content from codepen.io&#x22; class=&#x22;no-border max-full-width full-height flex-grow&#x22; src=&#x22;https://codepen.io/redbulldesign/embed/pvoXPmL/8b2de4434b0d58412c17829e26ad22b3?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

## Use Cases

### Contained Usage

The Person Item can be contained inside longer-form text and properly denoted within the link's tooltip.

:::Iframe{iframeHeight="0" code="<iframe title=&#x22;Embeded content from codepen.io&#x22; class=&#x22;no-border max-full-width full-height flex-grow&#x22; src=&#x22;https://codepen.io/redbulldesign/embed/rNQLJmR/e617655e30e5bff74f00afb2dc5604e9?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;493px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

:::Iframe{iframeHeight="0" code="<iframe title=&#x22;Embeded content from codepen.io&#x22; class=&#x22;no-border max-full-width full-height flex-grow&#x22; src=&#x22;https://codepen.io/redbulldesign/embed/vEYwqXy/ddc18e7ab12ec4e5bcda965e5479b0b3?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;493px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

### Sidebar

:::Iframe{iframeHeight="0" code="<iframe title=&#x22;Embeded content from codepen.io&#x22; class=&#x22;no-border max-full-width full-height flex-grow&#x22; src=&#x22;https://codepen.io/redbulldesign/embed/BaGzPVb/f5112f34b24adb9cf10fcde6d85b209a?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

