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

# Examples

## Basic Usage

The Story Item only needs a minimal amount of provided data to be used. It requires at a minimum that the headline 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/OJaQyJx/42f732374cee44545d3434ff59a5d282?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

**Best Practices:**

- The headline should only be used to describe the story.
- The headline should use [sentence-case](https://en.wikipedia.org/wiki/Letter_case#Sentence_case)

## 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/RwqQWgZ/0017c71956d0ac64f232737acec9dc3b?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

## Size

The size of the Story 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/VwVQvEM/32562f196029202b1ea2253ff33109cb?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 Story Item.

## Use Cases

### Contained Usage

The Story 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/VwVQvRr/e2a23608dca190c1f6dec86325204b7a?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#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/oNQEbXp/e4e4b6db2228b88d07a27184141ebe69?defaultTab=html%2Cresult&#x26;amp;editable=true&#x26;amp;theme-id=39623&#x22; height=&#x22;360px&#x22; loading=&#x22;lazy&#x22;></iframe>"}

:::

