Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
React Native docs
Data displayReact Native

Avatar

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

Public APILumenAvatarReact Native

Native example

Use Avatar

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

View verified React Native runtime capture
Avatar rendered in the Expo web renderer Lumen playground
Verified runtime captureExpo web renderer
tsx
<LumenAvatar
  fallback="SM"
  size="lg"
  label="Santiago Molina"
/>

Reference

Public API

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

APIValues or typeDefaultDescription
sourceImageSourcePropType?nilProvides the platform-native image source.
fallbackString?Provides fallback text, normally initials.
sizesm · md · lgmdUses a 32, 40, or 56 unit diameter.
labelString?nilNames an identity-bearing avatar.

Native behavior

Design and accessibility

When to use it

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

Accessibility

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

Shared component

Available on other platforms

Apple / SwiftUIAndroid / Compose
React Native docsNative primitives