# 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="https://837703843-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUX6zPRMFFK0yrTghj7cY%2Fuploads%2FbPraopQlaiKEsXPnDc0S%2Fstorage.png?alt=media&#x26;token=1dbda05d-15f5-4026-8357-e940c02ddb5c" 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="https://837703843-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUX6zPRMFFK0yrTghj7cY%2Fuploads%2F4hXOZ6o6OqY2ieBJOerO%2Fstorage%20integration.png?alt=media&#x26;token=218b7ff5-a1db-460d-97d7-ab502a9fcb21" 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.