After you have added a custom field of type media, with the administration or via plugin, you can assign media objects to the different entities. This is often used for products to add more images to the product detail page. If you want to learn more about custom fields you might want to take a look at this guide: Adding custom fields.
Overview
In the product detail page template, the key page.product.translated.customFields.xxx with the xxx, which is replaced with the corresponding custom field, contains the UUID of the media. Now the ID has just to be resolved with the function searchMedia:
This function resolves out the corresponding media objects for the given IDs in order to continue working with them afterwards. Here is an example with a custom field (custom_sports_media_id) on the product detail page:
{% set sportsMediaId = page.product.translated.customFields.custom_sports_media_id %}
6
​
7
{# fetch media as batch - optimized for performance #}
8
{% set mediaCollection = searchMedia([sportsMediaId], context.context) %}
9
​
10
{# extract single media object #}
11
{% set sportsMedia = mediaCollection.get(sportsMediaId) %}
12
​
13
{{ dump (sportsMedia) }}
14
{% endblock %}
Copied!
Avoid loops
This function performs a query against the database on every invocation and should therefore not be used within a loop. To resolve multiple ID's at once just pass it an array of ID's instead.
To read the media objects within the product listing we recommend the following procedure: