> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/knowledge-base/088-including-images-on-overleaf.md).

# Including images on Overleaf

When editing documents on Overleaf, it's straightforward to include images. This article explains how to upload images to your projects from your computer or from a URL, and how to include them in your typeset documents.

## Simple image upload

|                                                                                                                                        |                                                    |
| -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| To upload an image, in the editor go to the upper left corner and click the upload icon ![Uploadicon.png](/files/FFWAYwVXKryamc8gOPmf) | ![V2uploadbutton.png](/files/WoSoUz7rOGsDeeEavSpk) |

|                                                         |                                                      |
| ------------------------------------------------------- | ---------------------------------------------------- |
| a dialogue box will pop up for you to upload your files | ![V2uploaddialogue.png](/files/yyhxBL7KLd0hv5Ml4mbU) |

|                                                                                                     |                                                        |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| there you can either drag and drop your files or click ***Select files(s)*** to open a file browser | ![UploadingImagesEx3.png](/files/X5HwgnP6XAuvd6mpAtJn) |

|                                                                                                                                                                                    |                                                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| navigate to the right folder and select the images to upload. You can upload several files at once. After the upload process is complete you will see the files in the left panel. | ![UploadingImagesEx3b.png](/files/1UmJ4glzakN8T4vbUTT1) |

Now you can use your images within your LaTeX file, see the example below

```latex
\documentclass{article}
\usepackage[utf8]{inputenc}
\usepackage{graphicx}

\title{A project with images}
\author{Overleaf}
\date{}

\begin{document}

\maketitle

\section{Introduction}
\begin{figure}[htp]
    \centering
    \includegraphics[width=4cm]{InsertingImagesEx5}
    \caption{An image of a galaxy}
    \label{fig:galaxy}
\end{figure}

\end{document}
```

![UploadingImagesEx5b.png](/files/aABfRwolfHgx3Zrq6UHt)

notice that only the file name of the image is passed as parameter in `\includegraphics[width=4cm]{lion-logo}`

For more information about picture manipulation in LaTeX see the [further reading](#further-reading) for links to other documentation pages.

## Uploading images to a folder

If your project includes several images you might need to put them in a separate folder to keep everything organized.

|                                                                                                                                                    |                                                         |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| To create folders in Overleaf, go to the upper left corner of your editor and click the folder icon ![Foldericon.png](/files/gkwggvI3sSZH4EJxeEcN) | ![UploadingImagesEx6b.png](/files/6pRpNasuBppQwTESmClc) |

|                                                                             |                                                         |
| --------------------------------------------------------------------------- | ------------------------------------------------------- |
| an input box will appear, set a name for your folder and click ***Create*** | ![UploadingImagesEx7b.png](/files/prB4YIVQwhvmIdCeoXXY) |

|                                                                                                                                       |                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| Now you can see the folder in your left panel. You can drag and drop already uploaded files, even between folders in your left panel. | ![UploadingImagesEx8b.png](/files/aCHdq7qTNurdElRDt6H0) |

To upload files directly into a folder, click that folder then click on ***New*** and follow the instructions in the [previous section](#simple-image-upload).

Once you have some files in your folder you can use them within your document, see the example below.

```latex
\documentclass{article}
\usepackage[utf8]{inputenc}
\usepackage{graphicx}

\title{A project with images}
\author{Overleaf}
\date{}

\graphicspath{{Images/}}

\begin{document}

\maketitle

\section{Introduction}
\begin{figure}[htp]
    \centering
    \includegraphics[width=4cm]{InsertingImagesEx5}
    \caption{An image of a galaxy}
    \label{fig:galaxy}
\end{figure}

\end{document}
```

![UploadingImagesEx5b.png](/files/aABfRwolfHgx3Zrq6UHt)

The command `\graphicspath{ {Images/} }` tells LaTeX that the images are stored in *Images*, now you only have to use the file name instead of the full path in `\includegraphics`

For more information on image management in LaTeX look in [further reading](#further-reading) for links.

## Quick guide

* **Quick guide to uploading one or more images into your Overleaf project:**

In the top left corner of the editor click on the upload icon, then you can either drag and drop the files or click Select files(s) to browse in your local directories. After the uploading process is complete, you can use these images in your document.

* **Quick guide to uploading images into a folder:**

To create a new folder in the editor click the folder icon, set a name for your folder and click create. Now click your newly created folder and follow the process described in the previous paragraph to upload images, or drag and drop already uploaded images into your folder.

## Further reading

To learn more about image manipulation in LaTeX see.

* [Inserting Images](/latex/more-topics/27-inserting-images.md)
* [Positioning images and tables](/latex/figures-and-tables/02-positioning-images-and-tables.md)
* [Lists of tables and figures](/latex/figures-and-tables/03-lists-of-tables-and-figures.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 dynamically by asking a question.

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

```
GET https://overleaf-pro.ayaka.space/latex/knowledge-base/088-including-images-on-overleaf.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
