media

A media item attached to a product: image, video (adaptive streaming), or 3D model.

Properties

Property	Description
`media.alt`	Alt text.
`media.aspect_ratio`	Width ÷ height.
`media.duration`	—
`media.embed_url`	—
`media.external_id`	—
`media.file_size_bytes`	—
`media.file_type`	—
`media.filename`	—
`media.height`	Height in px.
`media.host`	Host being served.
`media.id`	Unique identifier.
`media.media_type`	Media type (‘image’, ‘video’, ‘model’).
`media.mime_type`	—
`media.position`	Position/order index.
`media.presentation`	—
`media.preview_image`	Preview image for the media.
`media.product_id`	—
`media.sources`	—
`media.src`	Source URL.
`media.url`	Relative URL of the resource.
`media.variants`	All variants.
`media.width`	Width in px.

Property list is generated from the storefront engine (MediaDrop), so it always matches what your theme can use. Inspect live values with {{ media | json }}.