The image component places a single image on the output canvas. The image can be static (uploaded directly to the output template), bound to an image field from a blueprint section (so the image changes with each edition), or pulled from a URL field.
When to use
- Cover page logo or client branding.
- Site photos uploaded by contributors in an edition image field.
- Organisation charts or diagrams that change per reporting period.
- Static reference diagrams (site plan, floor layout, route map).
Adding the component
- Open the report output in the Output Designer.
- Click + Insert → Image.
- Position and resize the component.
- In the Data tab, choose a static image or bind to a field.
Image source options
| Source type | Description |
|---|
| Static image | Upload an image file directly to the template. The same image appears in every output generated. |
| Blueprint image field | Bind to an image field in a blueprint section. The image shown is whatever the contributor uploaded for this edition. |
| URL field | Bind to a url field containing a direct image URL. The image is fetched at output generation time. |
Sizing and positioning
| Property | Options |
|---|
| Fit mode | Contain (fit within bounds), Cover (fill bounds, crop), Stretch (distort to fill), Original (1:1 pixel size). |
| Alignment | Horizontal: Left, Centre, Right. Vertical: Top, Middle, Bottom. |
| Max width | Cap the rendered width in pixels regardless of container size. |
| Max height | Cap the rendered height in pixels. |
| Aspect ratio lock | Maintain the original aspect ratio when resizing the component. |
Border and background
| Property | Options |
|---|
| Border | None, or configurable width, style, and colour. |
| Border radius | 0–50% (use 50% for circular cropping). |
| Background colour | Fill the component background when the image has transparency. |
| Shadow | Optional drop shadow. |
Empty state
When the bound field has no image uploaded:
| Property | Description |
|---|
| Fallback image | Show a specified static image when the field is empty. |
| Placeholder text | Show a text label (e.g. "No image provided") in the image area. |
| Hide when empty | Collapse the component when the field is blank. |
Caption
Add an optional caption below the image:
| Property | Description |
|---|
| Caption source | Static text, or bound to a text field in the same section. |
| Caption alignment | Left, Centre, Right. |
| Caption font size | 8–12pt. |
Export behaviour
- PDF / Word: Image is embedded at original resolution up to the configured max size. Vector SVG sources are preserved as vectors.
- Excel: Image is embedded as a floating image in the sheet.
- Uploaded images larger than 5 MB may slow PDF generation — resize before uploading if performance is a concern.