# Image views

Source: https://developer.apple.com/design/human-interface-guidelines/image-views
Skill: hig-components-content
Snapshot: 2025-02-02

---
<!-- hig-doctor:attribution -->
> **Source**: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/image-views.
> 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.

# Image views

## Best practices

**Use an image view when the primary purpose of the view is simply to display an image.**

**If you want to display an icon in your interface, consider using a symbol or interface icon instead of an image view.**

## Content

**Take care when overlaying text on images.**

**Aim to use a consistent size for all images in an animated sequence.**

## Platform considerations

### macOS

**If your app needs an editable image view, use an image well.**

**Use an image button instead of an image view to make a clickable image.**

### watchOS

**Use SwiftUI to create animations when possible.**

---

<!-- 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/image-views