# ImageReadBase64

## Syntax

```
ImageReadBase64( string )
```

## Arguments

| Name   | Type   | Required | Description                                            |
| ------ | ------ | -------- | ------------------------------------------------------ |
| string | String | Yes      | The base64-encoded string representing the image data. |

## Returns

`BoxImage` — The image object decoded from the base64 string.

## Description

Decodes a base64-encoded string into an image and returns it as a `BoxImage` object. This BIF is useful for importing images that are stored or transmitted as base64 strings, such as those embedded in data URIs or received from APIs.

## Example

```boxlang
// Load an image from a base64 string
img = ImageReadBase64( myBase64String );
```

## Related BIFs

* ImageRead
* ImageNew
* ImageGetBlob

## Notes

* The `string` argument must be a non-empty base64-encoded string representing valid image data.
* If the image cannot be decoded, an error is thrown.
* Returns a `BoxImage` object for use in other image BIFs.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://boxlang.ortusbooks.com/boxlang-framework/modularity/image-manipulation/reference/built-in-functions/imagereadbase64.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.