# Fields - Images

You can inject logos, photos or images into your spreadsheets cells dynamically. It's possible using special field type (available in API mode using Base64 or Image URL).

#### Syntax

You need to add an "%" in front of your field name The final syntax should be: **{%fieldName}**

```
{photo} - Regular Field that supports only regular text / number
{%photo} - Special field that creates images in output document
{#%people.photo} - Special field in table/section "people" that creates Images
```

### Adding a dynamic image to document template

You can add dynamic images to your templates using the "%" prefix. Examples: {%logo}, {%photo}, {%product}. Image will be placed with starting point of top-left corner for placeholder cell and can overlap cells on the right/below image placeholder cell.

<figure><img src="https://1713720388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRMYKAUZ0NsaDRvNONC3%2Fuploads%2Fv9PLtJ1PJkYt2wDRT6kF%2Fimage.png?alt=media&#x26;token=5a34aafd-c8d3-47db-946a-a81d9038dcb6" alt="" width="263"><figcaption><p>Template</p></figcaption></figure>

<figure><img src="https://1713720388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRMYKAUZ0NsaDRvNONC3%2Fuploads%2F9nJOJtvRCKz3r1kEx3Bl%2Fimage.png?alt=media&#x26;token=4d2be429-c81b-4fa1-ab1f-cb50d95e3212" alt="" width="273"><figcaption><p>Output</p></figcaption></figure>

### Dynamic Image Size

By default image size will be the same as the size of the image that is being sent, however, in most cases, we would like set width/height manually or limit the maximum width or maximum height to keep the aspect ratio of the image (recommended). You can do that by using **"size"** and **"maxSize"** formatters and providing desired width and height.

Most of the time you need to set maxSize (otherwise your image could be cut)

Examples:

```
{%image1}
{%image2 | size:250:100}
{%image3 | maxSize:300:500}
```

### How to pass the image data using API

Once you upload your document template that consists image tag ( e.g. {%logo} ) it should be detected on the template overview page

![](https://tawk.link/61dd64c2b84f7301d32a6e5b/kb/attachments/ujeNpbptjU.png)

You can send images over API in two ways:

* **as image url (provide full url to image)**
* **as text using base64 format**&#x20;

Supported file types: **jpg, png, svg.**

Sample Small Image example will be added to your API section:

![Example: Passing image using image url](https://tawk.link/61dd64c2b84f7301d32a6e5b/kb/attachments/7U2HykS_o0.png)


---

# 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://docs.documentero.com/documentation/fields-images.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.
