> For the complete documentation index, see [llms.txt](https://docs.informationhub.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.informationhub.io/project/storage.md).

# Storage

Storage is your project's file manager. Use it to upload, organise, and preview files associated with your project.

<figure><img src="/files/4Cb9uoBLLdg2ujTZf8Og" alt="The storage page"><figcaption><p>The storage page</p></figcaption></figure>

## The storage browser

The storage browser shows the files and folders at your current location. Use the **search bar** at the top to filter files and folders by name in real time.

Use the **pagination arrows** at the bottom to move between pages when a folder contains more than 100 items.

Click the **Back** button in the toolbar to navigate up to the parent folder.

## Create folders

Keep your files organised by creating folders:

1. Click the **Create** button in the toolbar.
2. Enter a name for the folder (2 to 128 characters).
3. Click **Create**.

{% hint style="info" %}
Empty folders are automatically removed. If you need to keep an empty folder, a placeholder file (KEEPME.md) is used to preserve it.
{% endhint %}

## Upload files

Click the **Upload** button in the toolbar to open the upload modal. From there you can:

* **Browse / Select Files** - opens a file picker to choose one or more files from your device
* **Take Picture** - opens your device camera to capture a photo
* **Record Video** - opens a video recorder to capture a video clip
* **Record Audio** - starts an audio recording using your device microphone

You can upload multiple files in one session. A progress bar shows the upload status for each file. When all uploads are complete, click **Return** to close the modal.

## File and folder options

Each file and folder has a three-dot options menu (**...**) with the following actions:

* **Rename** (folders only) - enter a new name for the folder
* **Download** - download the file directly to your device; for folders, downloads the entire folder as a ZIP archive
* **Extract** (ZIP files only) - extracts the contents of the ZIP archive into the current folder
* **Delete** - permanently removes the file or folder

{% hint style="warning" %}
Deleting a file or folder cannot be undone. Make sure you have a backup if needed.
{% endhint %}

## View a file

Click on any file in the storage browser to open the file view page. This page shows:

* An **image preview** for image files
* **File metadata** - size, file type, and storage path
* A **Download** button to save the file to your device
* An **Analyse** button for image files (see below)
* A **Delete** button to permanently remove the file

### AI image analysis

For image files, click the **Analyse** button to run an automated object-detection analysis. The platform identifies objects in the image and displays labels in the metadata. This is useful for quickly cataloguing field photos.

{% hint style="info" %}
The Analyse button is only shown for image file types.
{% endhint %}

## Selecting a file from within another feature

When another part of the platform asks you to pick a file from storage - for example when configuring a dashboard map component or importing data into a table - a storage browser popup appears. Use it the same way as the main storage browser:

1. Navigate into folders by clicking on them.
2. Click a file or folder to select it (selected items are highlighted).
3. Click **Select** to confirm your choice, or **Cancel** to close without selecting.

Use the **Back** button or the breadcrumb trail in the popup to navigate to a parent folder.


---

# 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:

```
GET https://docs.informationhub.io/project/storage.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.
