TemplatesLast updated: 4 February 2026

URL and HTML output

• {field} / {field:url} / {field:src}: derived URL for the selected image (processed by Image Pro)
• {field:img}: HTML output (<img> or <picture> when art direction alternates exist)
• {field:srcset}: derived srcset string (empty if not available for the current output)
• {field:sizes}: derived sizes string (empty if not available for the current output)
• {field:original_url}: the original file URL (unprocessed)

Common supporting variables

• {field:file_id}
• {field:alt}
• {field:decorative}: 1 or 0 (if enabled)

Preset and crop intent

• {field:preset_id}
• {field:preset}: preset info (string)
• {field:aspect_ratio}: normalised aspect ratio (if any)
• {field:aspect_ratio_raw}: raw stored aspect ratio value
• {field:crop}: crop string (if any)
• {field:crop_offset_x} / {field:crop_offset_y}
• {field:crop_rect_left} / {field:crop_rect_top} / {field:crop_rect_width} / {field:crop_rect_height}
• {field:width} / {field:height}: derived output dimensions (when available)

Focal point helpers

• {field:focal_x} / {field:focal_y}
• {field:focal_x_pct} / {field:focal_y_pct}
• {field:object_position}: CSS-friendly "X% Y%" string

Example usage:

<img src="{field}" style="object-position: {field:object_position};">

    Variable pairs


    You can use the base field as a variable pair to build custom markup:

{field}
    <a href="{url}">{img}</a>
{/field}

    Inside the pair, you can use the same variables listed above (for example {url} and {img}). You may also have access to basic file details (when available), such as:

<ul>
    <li><code>{file_name}</code>, <code>{file_title}</code>, <code>{file_description}</code></li>
    <li><code>{mime_type}</code>, <code>{file_size}</code></li>
    <li><code>{upload_location_id}</code>, <code>{upload_location_name}</code></li>
</ul>


    Art direction pair


    To iterate configured breakpoint rows (when art direction is enabled), use:

{field pair="art_direction"}
{if file_id}<source media="{media}" srcset="{url}">{/if}
{/field}


    Each row exposes variables such as

{index}, {media}, {file_id}, {preset_id}, plus {url} and {img}

    for that alternate.



    Precedence rules


    
Template parameters always win over stored intent and field-level defaults.