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:
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.