> For the complete documentation index, see [llms.txt](https://support.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.docstudio.com/user/template-builder/template-editor/how-to-add-or-edit-images-in-a-template.md).

# ​How to Add or Edit Images in a Template

This document explains how to add images to structured template documents, adjust image size, and understand upload limits.

### Add an image

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FT9OdCNviasysUi2yLQFi%2Fimage.png?alt=media&amp;token=988923ed-8b28-4d6c-8c66-772fc3d2b733" alt=""><figcaption></figcaption></figure>

1. Create a new template or open the template for editing.
2. Click inside the document body to place the cursor.
3. In the editor toolbar, click the **Image** ![](https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FOowbIij5fkZXXDbxe553%2Fimage.png?alt=media\&token=37d888b1-cf03-4e39-bdad-c86684581a9c) icon.
4. In the file picker, select an image and confirm.
5. The image is inserted at the cursor position.

{% hint style="info" %}
Supported formats:

* .png
* .jpg
* .jpeg
  {% endhint %}

### Edit image settings

{% columns %}
{% column width="58.333333333333336%" %}

1. Click the image to open the size controls.
2. Set the image width in **mm** or **%**.
3. Enter a width value manually, or use presets (25%, 50%, 100%).

{% hint style="info" %}
The height is calculated automatically to keep proportions. Sizing is relative to the document or the table cell where the image is placed.
{% endhint %}
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FlZSEp5mpwrs1fYcvcrsP%2Fimage.png?alt=media&amp;token=f79ffffb-5c25-4af7-9e1c-69ba4de2e11c" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Restrictions

{% hint style="danger" %}
You cannot add images to a dynamic table.
{% endhint %}

**Image upload limits:**

* max file size: **5 MB**
* max resolution: **1024 × 768**

**Display limit:**

* max displayed width: **618 px**

{% hint style="info" %}
If you upload a 1024×768 image, it will be scaled down to 618 px while keeping proportions.
{% endhint %}

### Related topics

* [How to Create a Structured Template](/user/template-builder/template-editor/how-to-create-a-structured-template.md)
* [How to Add and Manage Links in a Template](/user/template-builder/template-editor/how-to-add-and-manage-links-in-a-template.md)
* [How to Add and Manage Static Tables](/user/template-builder/template-editor/how-to-add-and-manage-static-tables.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.docstudio.com/user/template-builder/template-editor/how-to-add-or-edit-images-in-a-template.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
