Skip to content
  • Documentation >
  • Templating >
  • Twig function reference >
  • Image Twig functions

Image Twig functions

Image rendering

To render images, use the ibexa_render_field() Twig function with the variation name passed as an argument, for example:

1
2
3
4
5
6
7
``` html+twig
{{ ibexa_render_field(content, 'title') }}

{{ ibexa_render_field(content, 'image', {
    'template': '@ibexadesign/fields/image.html.twig',
    'attr': {class: 'thumbnail-image'},
    'parameters': {

Image information

ibexa_image_alias()

ibexa_image_alias() returns the selected variation of an image field.

Argument Type Description
field Ibexa\Contracts\Core\Repository\Values\Content\Field The image field.
versionInfo Ibexa\Contracts\Core\Repository\Values\Content\VersionInfo The VersionInfo that the field belongs to.
variantName string Name of the image variation to be used. To display the original image variation, use original as the variation name. 
1
{% set thumbnail = ibexa_image_alias(imageField, content.versionInfo, 'small') %}

Tip

You can access the name of a variation from the variation object with variation.name. You can, for example, use it as parameter in the ibexa_render_field() Twig function.

ibexa_content_field_identifier_first_filled_image()

ibexa_content_field_identifier_first_filled_image() returns the identifier of the first image field that isn't empty.

Caution

This function works only for Image fields. It doesn't work for ImageAsset fields.

Argument Type Description
content Ibexa\Contracts\Core\Repository\Values\Content\Content Content item to display the image for. 
1
{% set firstImage = ibexa_content_field_identifier_first_filled_image(content) %}

Examples

You can use ibexa_content_field_identifier_first_filled_image() to find and render the first existing image in an article:

1
2
{% set firstImage = ibexa_content_field_identifier_first_filled_image(content) %}
{{ ibexa_render_field(content, firstImage) }}