---
title: "Report - Images"
description: "The Image component lets you embed images into reports."
---

# Report - Images

> The Image component lets you embed images into reports.

The Image component lets you [embed images into reports](ignition-modules\reporting\report-design\images-in-reports\images-in-reports.md). Images can be dragged from a local computer, shared drive, webpage, or the Image Management Tool as files onto reports. They can also be pulled as binary data from a datasource. If no **Key** is associated with the image component, the dropped image will be used. If the **Key** does not link to a valid image, no image will be shown. The image displayed in the Report Designer is a placeholder. It will be replaced with the image associated with the image's **Key** when the report is generated or previewed.

In the image component's **Property Inspector**, you can drag a [parameter](ignition-modules\reporting\report-data\report-data.md#parameters) or a [datasource](ignition-modules\reporting\report-data\report-data.md#data-sources) column from the **Key Browser** into the **Key** field. The Data Key can resolve to a byte array, such as an image retrieved from a database, or a URL that points to an image on the web, or an image file on a disk. Remember that reports are generated on the Gateway, so the image source needs to be accessible from the Gateway computer.

[Keychain Expressions](ignition-modules\reporting\report-design\data-keys\keychain-expressions.md) can not be used in the data key, but the Key can be a parameter or datasource that dynamically constructs a path to an image. This allows you to easily change images in reports without changing the image component.

![" "](imageComponent.png)

**Report Design Component Palette Icon:**

![" "](imageComponentIcon.png)

## Properties

![" "](imageComponentProps.png)

|Property|Description|
|---|---|
|Fill|If true, the shape will fill its space with color.|
|Fill Selected|If fill is selected, the color that will fill the shape.|
|Opacity|How opaque the fill color is, between 0 and 1.|
|Stroke Style|What style of stroke or border to use: Hidden, Shape Outline, Border, or Double. To learn more about stroke styles, refer to [Stroke and Fill Properties](ignition-modules\reporting\report-design\stroke-and-fill-properties-for-reports\stroke-and-fill-properties-for-reports.md).|
|Stroke|[Details for the chosen stroke](ignition-modules\reporting\report-design\stroke-and-fill-properties-for-reports\stroke-and-fill-properties-for-reports.md). Each Stroke has its own properties depending on the Stroke Style chosen.|
|Grow to Fit|If true, rescale the original image to fit the shape.|
|Key	|Data Key for this image.|
|Padding|Padding between the image and the shape's bounds.|
|Page Index|For multi-page images, sets the page index to use.|
|Preserve Aspect Ratio|If true, preserve the aspect ratio when resizing the image.|
|Radius|The amount to radius the corners of this shape.|
|Roll|Number of degrees this shape is rotated clockwise.|
|Scale X|Amount to scale the width of this shape. 1 is scale to 100%.|
|Scale Y|Amount to scale the height of this shape. 1 is scale to 100%.|
|URL|  A link to attach to this reporting component. Will be a clickable hyperlink if the report is exported as a PDF. You can use the values below to link to internal pages.Page:Next - Navigates to the next page. Page:Back - Navigates to the previous page.Page:Number - Replace "Number" with a numeral. Navigates to the specified page.|
|Visible|If true, the shape will be visible.|
|Width|Width of this shape in pixels.|
|Height|Height of this shape in pixels.|
|X|Horizontal distance in pixels between the left edge of this shape and the left edge of the page.|
|Y|Vertical distance in pixels between the top edge of this shape and the top edge of the page.|

## Example

![" "](imageComponentExample.png)

|Property|Value|
|---|---|
|Key|Image Path|

The image in this report was created using a **Parameter** that resolved to a URL.