The media object

The media object represents an object returned in a product.media array. The media object is an abstract object that can represent the following object types:

• image
• model
• video
• external_video

You can use media filters to generate URLs and model-viewer tags so that media is rendered on the product page.

To learn more about using product media in your theme, refer to Adding media to themes.

The media object has the following attributes. Some attributes unique to each media type are also available. For more information about these additional attributes, refer to the reference for each supported object type.

media.alt

Returns the alt tag of the media, set in the Products page of the Admin.

media.id

Returns the ID of the media.

media.media_type

Returns the media type of the object.

The media_type property can be used to filter the product.media array for all media of a desired type.

Input

{% assign images = product.media | where: "media_type", "image" %}
{% for image in images %}
  {{ image.alt }}
{% endfor %}

Output

Image of the black stroller

Image of the grey stroller

media.position

Returns the position of the specific media object in the product object's media array.

media.preview_image

Returns a preview image for the media.