# SpreadsheetAddImage

Adds an image to a spreadsheet.

## Method Signature

```
SpreadsheetAddImage(spreadsheetObj=[any], filepath=[any], row=[any], column=[any], anchor=[any])
```

### Arguments

| Argument         | Type      | Required | Description                                            | Default |
| ---------------- | --------- | -------- | ------------------------------------------------------ | ------- |
| `spreadsheetObj` | `ANY`     | `true`   | The spreadsheet object.                                |         |
| `filepath`       | `STRING`  | `true`   | The path to the image file.                            |         |
| `row`            | `NUMERIC` | `false`  | The row to place the image (1-based). Default is 1.    |         |
| `column`         | `NUMERIC` | `false`  | The column to place the image (1-based). Default is 1. |         |
| `anchor`         | `NUMERIC` | `false`  | Anchor type for image positioning. Default is 1.       |         |

## Examples

Add image to spreadsheet:

```js
// Insert image at cell A1
var spreadsheet = SpreadsheetNew();
SpreadsheetAddImage( spreadsheet, "/path/to/image.png", 1, 1 );
```

## Related

* [SpreadsheetSetHeaderImage()](https://boxlang.ortusbooks.com/boxlang-framework/boxlang-plus/modules/bx-spreadsheet/reference/built-in-functions/spreadsheetsetheaderimage) - Add to header
* [SpreadsheetSetFooterImage()](https://boxlang.ortusbooks.com/boxlang-framework/boxlang-plus/modules/bx-spreadsheet/reference/built-in-functions/spreadsheetsetfooterimage) - Add to footer
* [Multimedia Guide](https://github.com/ortus-boxlang/boxlang-docs/blob/v1.x/boxlang-framework/boxlang-plus/modules/bx-spreadsheet/multimedia.md) - Working with images
