Data displayApple

Avatar

Display a native image or fallback identity at shared avatar sizes.

Public APILumenAvatarApple / SwiftUISwift product: LumenUI

Apple availability

Supported native targets

Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.

iPhone · iOS 16+iPad · iPadOS 16+Mac · macOS 13+Apple TV · tvOS 16+Apple Vision · visionOS 1+Apple Watch · watchOS 9+

Native example

Keep image sources native to the platform. Use initials or a short fallback when no image is available.

Verified runtime captureiPhone simulator

LumenAvatar(
    fallback: "SM",
    size: .lg,
    label: "Santiago Molina"
)

Reference

The primary shared and platform-specific options exposed by LumenAvatar.

API	Values or type	Default	Description
image	`Image?`	`nil`	Provides the platform-native image source.
fallback	`String`	`?`	Provides fallback text, normally initials.
size	`sm · md · lg`	`md`	Uses a 32, 40, or 56 unit diameter.
label	`String?`	`nil`	Names an identity-bearing avatar.

Native behavior

Keep image sources native to the platform. Use initials or a short fallback when no image is available.

Supply a label when the avatar conveys identity. Omit it when the same name appears adjacent and the image is decorative.

Shared component