<!--
{
  "documentType" : "article",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/Images",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Images"
}
-->

# Images

Add images and symbols to your app’s user interface.

## Overview

Display images, including
<doc://com.apple.documentation/design/Human-Interface-Guidelines/sf-symbols>,
images that you store in an asset catalog, and images that you store on disk,
using an [`Image`](/documentation/SwiftUI/Image) view.

![](images/com.apple.SwiftUI/images-hero@2x.png)

For images that take time to retrieve
— for example, when you load an image from a network endpoint —
load the image asynchronously using [`AsyncImage`](/documentation/SwiftUI/AsyncImage).
You can instruct that view to display a placeholder during the load operation.

For design guidance, see
<doc://com.apple.documentation/design/Human-Interface-Guidelines/images>
in the Human Interface Guidelines.

## Topics

### Creating an image

[`Image`](/documentation/SwiftUI/Image)

A view that displays an image.

### Configuring an image

[Fitting images into available space](/documentation/SwiftUI/Fitting-Images-into-Available-Space)

Adjust the size and shape of images in your app’s user interface by applying view modifiers.

[`imageScale(_:)`](/documentation/SwiftUI/View/imageScale(_:))

Scales images within the view according to one of the relative sizes
available including small, medium, and large images sizes.

[`imageScale`](/documentation/SwiftUI/EnvironmentValues/imageScale)

The image scale for this environment.

[`Image.Scale`](/documentation/SwiftUI/Image/Scale)

A scale to apply to vector images relative to text.

[`Image.Orientation`](/documentation/SwiftUI/Image/Orientation)

The orientation of an image.

[`Image.ResizingMode`](/documentation/SwiftUI/Image/ResizingMode)

The modes that SwiftUI uses to resize an image to fit within
its containing view.

### Loading images asynchronously

[`AsyncImage`](/documentation/SwiftUI/AsyncImage)

A view that asynchronously loads and displays an image.

[`AsyncImagePhase`](/documentation/SwiftUI/AsyncImagePhase)

The current phase of the asynchronous image loading operation.

### Setting a symbol variant

[`symbolVariant(_:)`](/documentation/SwiftUI/View/symbolVariant(_:))

Makes symbols within the view show a particular variant.

[`symbolVariants`](/documentation/SwiftUI/EnvironmentValues/symbolVariants)

The symbol variant to use in this environment.

[`SymbolVariants`](/documentation/SwiftUI/SymbolVariants)

A variant of a symbol.

### Managing symbol effects

[`symbolEffect(_:options:isActive:)`](/documentation/SwiftUI/View/symbolEffect(_:options:isActive:))

Returns a new view with a symbol effect added to it.

[`symbolEffect(_:options:value:)`](/documentation/SwiftUI/View/symbolEffect(_:options:value:))

Returns a new view with a symbol effect added to it.

[`symbolEffectsRemoved(_:)`](/documentation/SwiftUI/View/symbolEffectsRemoved(_:))

Returns a new view with its inherited symbol image effects
either removed or left unchanged.

[`SymbolEffectTransition`](/documentation/SwiftUI/SymbolEffectTransition)

Creates a transition that applies the Appear, Disappear, DrawOn or
DrawOff symbol animation to symbol images within the inserted or
removed view hierarchy.

### Setting symbol rendering modes

[`symbolRenderingMode(_:)`](/documentation/SwiftUI/View/symbolRenderingMode(_:))

Sets the rendering mode for symbol images within this view.

[`symbolRenderingMode`](/documentation/SwiftUI/EnvironmentValues/symbolRenderingMode)

The current symbol rendering mode, or `nil` denoting that the
mode is picked automatically using the current image and
foreground style as parameters.

[`SymbolRenderingMode`](/documentation/SwiftUI/SymbolRenderingMode)

A symbol rendering mode.

[`SymbolColorRenderingMode`](/documentation/SwiftUI/SymbolColorRenderingMode)

A method of filling a layer in a symbol image.

[`SymbolVariableValueMode`](/documentation/SwiftUI/SymbolVariableValueMode)

A method of rendering the variable value of a symbol image.

### Rendering images from views

[`ImageRenderer`](/documentation/SwiftUI/ImageRenderer)

An object that creates images from SwiftUI views.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)