> For the complete documentation index, see [llms.txt](https://docs.papers.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.papers.ai/writing-and-editing/inserting-images-and-figures.md).

# Inserting images and figures

Add an image to your project, then reference it from whichever file you're writing in. In Word documents, you can resize, rotate, flip, reposition, and caption an image directly in Papers AI (see the Word tab below). Papers AI doesn't crop images, in Word or any other format; edit the image in another tool and re-import it with the same filename to refresh every reference automatically.

## Add an image

1. Drag the image file into the file explorer, ideally into a folder like `figures/`.
2. Use a stable, descriptive filename before you reference it anywhere. Renaming later means updating every reference by hand.

## Reference it in your document

{% tabs %}
{% tab title="Word" %}
Use the image tool in the DOCX toolbar to insert it, then drag to resize or reposition. Right-click the image for more controls: rotate or flip it, set how text wraps around it (inline, square, behind text, or in front of text), and add a caption. Captions number themselves automatically as "Figure N."
{% endtab %}

{% tab title="LaTeX" %}
Use `\includegraphics`, wrapped in a `figure` environment for a caption and a label you can cross-reference:

{% code title="main.tex" %}

```latex
\begin{figure}[h]
\centering
\includegraphics[width=0.6\textwidth]{figures/overview.png}
\caption{The workspace shell.}
\label{fig:overview}
\end{figure}
```

{% endcode %}
{% endtab %}

{% tab title="Typst" %}
Reference the image with Typst's own figure syntax, pointing at the same project-relative path.
{% endtab %}

{% tab title="Markdown" %}
Use standard Markdown image syntax:

```markdown
![alt text](figures/overview.png)
```

{% endtab %}
{% endtabs %}

Compile or preview afterward to confirm the image renders. For LaTeX, check the path matches exactly, since paths are case-sensitive.

{% hint style="success" %}
If you're not sure how to write the figure or caption syntax for your format, ask the AI. Tell it the filename and caption, and it can draft the block for you. See [Using AI](/using-ai/using-ai.md).
{% endhint %}

## Troubleshooting

<details>

<summary>The image doesn't appear in preview</summary>

Check the file path and reference syntax, then recompile.

</details>

<details>

<summary>You moved the file and now references are broken</summary>

Update the path in every document that referenced it.

</details>

<details>

<summary>The rendered output has broken image links</summary>

Search for the old filename and replace it with the current path.

</details>

## Next steps

* [Working with Word documents](/writing-and-editing/working-with-word-documents.md)
* [Compiling and fixing errors](/writing-and-editing/compiling-and-fixing-errors.md)