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

# Uploading images

*What you'll get: your images in Biodock, in the folders you choose, ready to view, label and analyse.*

{% hint style="info" %}
Already have your data in the cloud? Import it with the [AWS S3 integration](https://docs.biodock.ai/files/aws-s3-integration.md), or the [Google Cloud Storage integration](https://docs.biodock.ai/files/google-cloud-storage-integration.md) if it is turned on for your account.
{% endhint %}

## Upload into the right place

Your personal account and each [workspace](https://docs.biodock.ai/workspaces/workspaces.md) have their own **Files**. Files never move between them, so first switch to the place you will work in, using the account switcher in the top bar. In a workspace, everyone works from the workspace's Files, and each item's **Access** decides who can see it.

## Upload files

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-04c0c1f6b75be1de97bc463866ee4674405f7bca%2Fdocs-files-upload.gif?alt=media" alt="In a folder in Files, Upload files is clicked, Save inside a new sub-folder is ticked and named Control, four images are dropped into the dialog, Upload 4 files is clicked, and the Recent uploads tray shows the upload in progress"><figcaption><p><strong>Upload files</strong> → tick <strong>Save inside a new sub-folder</strong> → add your files → <strong>Upload 4 files</strong>. Follow it under <strong>Recent uploads</strong>.</p></figcaption></figure>

1. Click **Files** in the sidebar, open the **My Files** tab, and go to the folder you want the images in. To make a folder first, click **New folder**, type a **Folder name** and click **Create folder**.
2. Click **Upload files**. The **Upload images** dialog opens, with the folder you are in under **Destination**.
3. Add your images:
   * **From your computer:** drag them into the dialog, or click **browse files**.
   * **A whole folder:** click **browse folders**. Every file in it is uploaded, including files in sub-folders, and the folder structure is kept.
   * **From a cloud drive:** click Google Drive, Box, Dropbox or OneDrive, sign in, and pick your files. Files picked this way go straight into the destination folder, without their folder structure.
4. Optionally, tick **Save inside a new sub-folder** and type a name. Biodock creates that folder inside the current one and puts the files in it.
5. Click the upload button. It shows how many files are ready, for example **Upload 12 files**.

Keep the window open while the files transfer. After that, Biodock processes them on its servers, and you can close the window. Follow the progress with **Recent uploads** (the upload icon in the top bar). Every upload and import is also listed on the **Past uploads** tab of **Files**.

{% hint style="info" %}
**Use folders for your conditions.** When you analyse a set of folders, each folder becomes a group in the results. Upload each condition, such as Control and Treatment, into its own folder.
{% endhint %}

### Keeping a folder structure

If you upload a folder with this structure using **browse folders**:

* `3/22/2022 Scans`
  * `test-image1.tif`
  * `Control`
    * `control-image1.tif`
    * `control-image2.tif`
  * `Experiment`
    * `experiment-image1.tif`
    * `experiment-image2.tif`

Biodock creates the folders `3/22/2022 Scans`, `Control` and `Experiment`, with each file in its place.

## Adaptive normalization

Tick **Adaptive normalization** to boost contrast when the image is first shown. It works best for slides with subtle staining. Fluorescence images usually look fine without it.

## Upload limits

* **File size:** up to 64 GB per file for whole-slide formats (such as .svs, .ndpi and .mrxs), and up to 40 GB per file for every other format.
* **Storage:** the dialog shows how much storage you have left. An upload that would go over it is refused.
* **Free accounts** have a limit on file size after the first few files. See [Credits, storage and limits](https://docs.biodock.ai/account/credits-storage-and-limits.md#upload-limits).

Files that break a limit are listed in the dialog with the reason, and left out of the upload.

See [Supported image types](https://docs.biodock.ai/files/supported-image-types.md) for the formats you can upload, and how to upload multi-file formats such as MRXS and VSI.


---

# 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://docs.biodock.ai/files/uploading-images.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.
