images

The global images object resolves an admin-managed image whose media status is ready. Use it for store media; use asset_url for files inside a theme’s assets/ directory.

Example

{% assign chart = images['size-chart.jpg'] %}
{% if chart %}
  {{ chart | image_url: width: 800 | image_tag: alt: 'Size chart' }}
{% endif %}

Filenames must contain an extension, cannot contain a slash, and are limited to 255 characters. One render can resolve at most 20 unique filenames. Repeated lookups are memoized; missing, non-image, malformed, and over-limit lookups return nil.

Properties

Property	Description

This object has no static properties; validated filenames are dynamic keys. The returned value is an image variant of the media object.

Property list is generated from the storefront engine (ImagesDrop), so it always matches what your theme can use. Use {{ images | json }} only as a curated debug snapshot; it can omit lazy or otherwise public properties.