← All components

<image>

Content Wallpaper Widget

Displays a local or remote image with expression-driven source, sizing, and styling.

Example

<image src="https://example.com/photo.jpg" width="120dp" height="80dp" contentScale="crop" />

Attributes

Name Type Default Description
src String — Image source: URL, file URI, or asset path
contentScale String
fitcropfillBoundsfillWidthfillHeightinsidenone
fit Scale mode applied when source aspect ratio differs from bounds.
tint Color — Optional color overlay tint
width Dp — Image width
height Dp — Image height
placeholder Color — Background color shown while loading
crossfade Boolean true Enable crossfade transition
align String
topStarttopCentertopEndcenterStartcentercenterEndbottomStartbottomCenterbottomEnd
center Content alignment within bounds.