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

# Report Component - Images

> The Image component lets you embed images into reports.

![](image.png)

**Component Palette Icon:**  
![](image-palette.png)

## Description
The Image component lets you [embed images into reports](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](reporting/report-data/report-parameters.md) or a [datasource](reporting/report-data/report-data.md) 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](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.

## Properties
![](Properties.png)

| Property 	| Description 	| Category 	|
|---	|---	|---	|
| Fill 	| If true, the shape will fill its space with color. 	| Stroke and Fill 	|
| Fill Selected 	| If fill is selected, the color that will fill the shape. 	| Stroke and Fill 	|
| Opacity 	| How opaque the fill color is, between 0 and 1. 	| Stroke and Fill 	|
| 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](reporting/report-design/stroke-and-fill-properties-for-reports/stroke-and-fill-properties-for-reports.md). 	| Stroke and Fill 	|
| Stroke 	| [Details for the chosen stroke.](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. 	| Stroke and Fill 	|
| Grow to Fit 	| If true, rescale the original image to fit the shape. 	| Image Shape 	|
| Key 	| Data Key for this image. 	| Image Shape 	|
| Padding 	| Padding between the image and the shape's bounds. 	| Image Shape 	|
| Page Index 	| For multi-page images, sets the page index to use. 	| Image Shape 	|
| Preserve Aspect Ratio 	| If true, preserve the aspect ratio when resizing the image. 	| Image Shape 	|
| Radius 	| The amount to radius the corners of this shape. 	| Rectangle Shape 	|
| Roll 	| Number of degrees this shape is rotated clockwise. 	| Basic Properties 	|
| Scale X 	| Amount to scale the width of this shape. 1 is scale to 100%. 	| Basic Properties 	|
| Scale Y 	| Amount to scale the height of this shape. 1 is scale to 100%. 	| Basic Properties 	|
| Visible 	| If true, the shape will be visible. 	| Basic Properties 	|
| Width 	| Width of this shape in pixels. 	| Basic Properties 	|
| Height 	| Height of this shape in pixels. 	| Basic Properties 	|
| X 	| Horizontal distance in pixels between the left edge of this shape and the left edge of the page. 	| Basic Properties 	|
| Y 	| Vertical distance in pixels between the top edge of this shape and the top edge of the page. 	| Basic Properties 	|

## Example
### Image in a Report
![](image-in-report.png)

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

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