# Uploading images

When editing documents on Overleaf, it's straightforward to upload 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

{% stepper %}
{% step %}
To upload an image, in the editor go to the upper left corner and click the upload icon![](/files/g4aH85ITuf04lEQ7Mnoe) .

<figure><img src="/files/L2OJYV1xFzyAUkGWpScB" alt="The Upload icon in the Overleaf Editor"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
A dialogue box will pop up for you to upload your files. There you can either drag and drop your files or click either *Select files* or *Select a folder* to open a file browser.

<figure><img src="/files/9dWCeLeQObSmU31FTxvp" alt="The Add Files dialog box"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Navigate to and select the images to upload. You can upload several files at once.

<figure><img src="/files/vAolKw9ZgIqFfKtKM11M" alt="A file browser"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
After the upload process is complete you will see the files in the left panel.

<figure><img src="/files/VrvO4l0HrWIjhQOl3OZi" alt="The Overleaf Editor with the image upload in the left panel."><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

{% columns %}
{% column width="50%" %}
{% code overflow="wrap" %}

```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}
```

{% endcode %}
{% endcolumn %}

{% column %}

<figure><img src="/files/l6X1yYYtUAHli32gesU5" alt="Example image created using the example code"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Notice that only the file name of the image is passed as parameter in `\includegraphics[width=4cm]{InsertingImagesEx5}` .

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.

{% stepper %}
{% step %}
To create folders in Overleaf, go to the upper left corner of your editor and click the folder icon![](/files/eGtkqiSaCrlXloRIpHgy)

<figure><img src="/files/0u3hNtG1pDolf88gb2XV" alt="The Folder icon in the Overleaf Editor"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
An input box will appear. Set a name for your folder and click *Create*.

<figure><img src="/files/4emXiOyEnsYtTMCMxGwH" alt="The New Folder modal."><figcaption></figcaption></figure>
{% endstep %}

{% step %}
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.

<figure><img src="/files/mZ1UmxSzBI2JTVnH1ILI" alt="The Overleaf Editor with a folder in the left panel."><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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.

{% columns %}
{% column %}
{% code overflow="wrap" %}

```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}
```

{% endcode %}
{% endcolumn %}

{% column %}

<figure><img src="/files/l6X1yYYtUAHli32gesU5" alt="Example image created using the example code"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

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

Learn more about image manipulation in LaTeX:

* [Positioning images and tables](https://learnwiki.overleaf.com/learn/Positioning_images_and_tables)
* [Lists of tables and figures](https://learnwiki.overleaf.com/learn/Lists_of_tables_and_figures)


---

# 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.overleaf.com/writing-and-editing/inserting-images/uploading-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.
