# Images

Source: https://developer.apple.com/design/human-interface-guidelines/images
Skill: hig-foundations
Snapshot: 2025-02-02

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

# Images

## Resolution

**Provide high-resolution assets for all bitmap images in your app, for every device you support.**

**In general, design images at the lowest resolution and scale them up to create high-resolution assets.**

## Best practices

**Include a color profile with each image.**

**Always test images on a range of actual devices.**

## Platform considerations

### tvOS

#### Layered images

**Use standard interface elements to display layered images.**

**Identify logical foreground, middle, and background elements.**

**Generally, keep text in the foreground.**

**Keep the background layer opaque.**

**Keep layering simple and subtle.**

**Leave a safe zone around the foreground layers of your image.**

**Always preview layered images.**

### visionOS

**Create a layered app icon.**

**Prefer vector-based art for 2D images.**

**If you need to use rasterized images, balance quality with performance as you choose a resolution.**

#### Spatial photos and spatial scenes

**Make sure spatial photos render correctly in your app.**

**Prefer the feathered glass background effect to display text over spatial photos.**

**Take visual comfort into consideration when you make spatial photos from existing 2D content.**

**Display spatial photos and spatial scenes in standalone views.**

**Use spatial scenes in your app for specific moments.**

**When displaying immersively, prefer minimal UI.**

**Prefer displaying larger spatial scenes that you center in someone’s field of view.**

### watchOS

**In general, avoid transparency to keep image files small.**

**Use autoscaling PDFs to let you provide a single asset for all screen sizes.**

---

<!-- 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/images