# Top Shelf

Source: https://developer.apple.com/design/human-interface-guidelines/top-shelf
Skill: hig-components-system
Snapshot: 2025-02-02

---
<!-- hig-doctor:attribution -->
> **Source**: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/top-shelf.
> This file is a structured index of that content, snapshot 2025-02-02.
> Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.

# Top Shelf

## Best practices

**Help people jump right into your content.**

**Feature new content.**

**Personalize people’s favorite content.**

**Avoid showing advertisements or prices.**

**Showcase compelling dynamic content that can help draw people in and encourage them to view more.**

**If you don’t provide the recommended full-screen content, supply at least one static image as a fallback.**

**Avoid implying interactivity in a static image.**

## Dynamic layouts

  * A carousel of full-screen video and images that includes two buttons and optional details

  * A row of focusable content

  * A set of scrolling banners

### Carousel actions

**Provide a title.**

### Carousel details

**Provide a title that identifies the currently playing content.**

### Sectioned content row

**Provide enough content to constitute a complete row.**

#### 16:9

**Be aware of additional scaling when combining image sizes.**

#### Scrolling inset banner

**Provide three to eight images.**

**If you need text, add it to your image.**

---

<!-- hig-doctor:canonical-footer -->
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/top-shelf