# UI Bakery Storage

**UI Bakery Storage** is a built-in file storage solution for UI Bakery apps. It lets you create buckets, upload files, organize them by path, and serve them directly in your apps. You can access it from the Storage tab at the bottom of the workspace menu.

<figure><img src="/files/H4Kk5veLOhRcLGVfzNST" alt=""><figcaption></figcaption></figure>

### Key Features

**1. Bucket-based storage**

* Create buckets: Set up isolated storage spaces for different apps, teams, or use cases.
* Simple organization: Keep files structured with folders and paths such as `images/`, `documents/`, or `attachments/forms/`.
* Built-in access control: Storage buckets are connected to UI Bakery datasources, so access follows datasource permissions.

**2. File management**

* Upload files: Store images, documents, and other assets directly in UI Bakery Storage.
* Browse stored objects: View bucket contents in the Storage tool and navigate files by folder structure.
* Delete or rename files: Maintain your storage without leaving the UI Bakery workspace.

**3. Ready-to-use asset URLs**

* Direct file links: Each stored object includes an `assetUrl` that can be used for previews, download links, and file references.
* App-friendly usage: Use stored files in image components, links, file previews, and custom app code.
* Works across environments: The same storage flow is available in development and production.

### Limitations

UI Bakery Storage is intended for file storage, not relational data. Bucket contents are listed by prefix, and a single list request currently returns up to 1000 objects, so large buckets should be organized with clear folder prefixes.

### Integration with UI Bakery

UI Bakery Storage integrates with UI Bakery apps through a connected Bakery Storage datasource. Once connected, you can use it in actions to list objects, upload files, and delete files.

<figure><img src="/files/x309oP9esluTjhyRqdTD" alt=""><figcaption></figcaption></figure>

UI Bakery Storage supports the following action patterns:

* List objects: Retrieve bucket contents, optionally filtered by prefix.
* Upload object: Upload a file to a specific object path.
* Delete object: Remove a file from storage.

For previews and open links, use the `assetUrl` returned by Bakery Storage instead of constructing file URLs manually. This makes it easy to build file galleries, attachment flows, document hubs, and other file-based app experiences.


---

# 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.uibakery.io/extras/ui-bakery-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.