Use App Storage to store, organize, and manage files used by your running app, including images, videos, documents, and user uploads.

Before using App Storage, connect the project to Atoms Cloud. If it is not connected, ask the Agent to connect Atoms Cloud or follow Atoms Cloud.

Understand App Storage in Atoms Cloud

App Storage stores files that your project needs to keep and access. It is separate from structured data stored in your Database, files uploaded in Chat, and the files that make up your project’s code.

Key terms

• Bucket: The main container used to store and group related files. You can think of a bucket like a storage area for one category of files. Each bucket is set to either Public or Private, which controls who can access the files inside it.
• Folder: An optional way to organize files within a bucket. Folders work like the folders on your computer and can help keep larger collections of files easier to manage.
• Object: An individual file stored in a bucket or folder, such as an image, document, video, or other uploaded file.
• Object key: The unique path used to identify where a file is stored inside a bucket. For example, images/profile/avatar.png could be the object key for an image stored inside an images/profile folder.

Choose Public or Private

Choose the bucket type before creating it:

Bucket type	Use it for
Private	Sensitive, account-specific or user-uploaded files.
Public	Non-sensitive files that are intentionally safe to expose publicly.

Use Private for sensitive or user-specific files. If you run into an access error, do not change the bucket to Public just to make the file accessible. Instead, make sure your app checks that the person requesting the file has permission to access it.

Open App Storage in Atoms Cloud

1. Open your project on a desktop device.
2. In the same workspace toolbar where the App Viewer is, select Atoms Cloud.
3. Select App Storage in the Atoms Cloud sidebar.

Permissions in App Storage

App Storage uses your workspace role. Both Editors and workspace owners can manage storage for projects they can open. People who are not members of the workspace cannot open or manage the project’s App Storage.

The bucket’s Public or Private setting does not change who can manage it in Atoms Cloud. That setting controls how the running app can provide access to the files; workspace permissions control who can manage the storage from the Atoms Cloud workspace.

Create a bucket

An app can have up to 10 buckets. Create separate buckets when different groups of files need different access settings or should be kept separate for easier organization.

1. On the App Storage page, select Create Bucket.
2. Under Bucket Name, enter a unique name for the bucket. The name must:
   • contain 3–63 characters;
   • use only lowercase letters, numbers, and hyphens; and
   • begin and end with a letter or number.
3. Under Bucket Type, choose Private or Public. Public is selected by default, so make sure you choose the access level you want before continuing.
4. Select Create.

The new bucket appears on the App Storage page with its name, type, and creation date. Select the bucket to open it and view its contents.

Select Create Bucket in App Storage.

Bucket names cannot be changed after creation, so choose a clear name that you will not need to change later. If your app already has 10 buckets, Create Bucket will no longer be available.

Upload and organize files

Inside a bucket, you can upload files directly or create an empty folder without uploading any files first.

Create a new folder

1. Open the bucket or folder where you want to create the new folder.
2. Select Add Folder.
3. Enter a name for the folder, then select Create. Folder names can contain letters, numbers, dots (.), hyphens (-), and underscores (_), and can be no more than 100 characters. Folder names cannot be changed after creation.

Name the folder, then select Create.

Upload files

1. Open the bucket or folder where you want to store the files.
2. Select Upload, then choose one or more files from your device. Each file can be up to 100 MB.
3. Wait for the upload to finish, then check that the files appear in the list.

The file list shows each item's Name, Type, Size, Last Modified date, and available Actions. If you need to reload the contents of the current folder, select the refresh button.

Upload files into the selected bucket or folder.

Preview and manage files

Select a file to open File Details. Supported images and videos can be previewed in the panel. Other file types show their available details and can still be downloaded. If all credits are used, File Details shows a credit-exhausted state, and single-file Download directs you to Upgrade instead of downloading.

Manage one file

Open ... in the file's Actions column, then choose:

• Download to save a local copy when credits are available. If all credits are used, this action directs you to Upgrade instead.
• Rename to change the file name. The new name can use letters, numbers, dots, hyphens and underscores.
• Delete to remove the file after confirmation.

Use the file’s actions menu to download, rename, or delete it.

Manage several files

1. Select the checkbox beside each file. Folders are not included in batch selection.
2. Select Download to download the selected files together, or select Delete.
3. If deleting, review the number of selected files and confirm Delete.

Deletion cannot be undone from App Storage. Before renaming or deleting a file, check whether the app still uses its object key. Update any stored references afterward so the app does not continue requesting the old key.

Use a stored file in your app

Your app identifies each stored file using its bucket name and object key. The object key shows where the file is located inside the bucket. For example, images/profile/avatar.png could be the object key for an image stored inside an images/profile folder.

Store the bucket name and object key in your app’s database so the app can locate the file later. When your app needs to display or download the file, it can use these details to request an access URL.

Access URLs may be temporary. Do not save them as permanent app data, hardcode them into your app, or share them in Chat, screenshots, logs, or support messages. Instead, store the object key and request a new access URL when the file needs to be accessed.

Do not store API keys, passwords, or other credentials in App Storage. Store private runtime credentials in Keys and secrets. Only the workspace owner can manage private runtime credentials there. If you are an Editor, ask the workspace owner to add or update the credential.

Current limits

Limit	Current value
Buckets per app	10
Size of each uploaded file	100 MB

For current Cloud usage and capacity information, see Cloud & AI Wallet.

FAQ

My disk space is full. How do I free up storage?

1. Check the current storage usage and identify the largest chats, projects, or files.
2. Download or back up anything you may need later.
3. Delete only items you no longer need. If deleting a chat presents an option to remove associated disk data, select it only after confirming that the data can be discarded.
4. Remove unneeded large files, then refresh and check the available space again.

Deletion may be permanent and can affect a project that references the removed file. If the usage does not fall after cleanup, contact Support with a storage screenshot, your plan, and the affected account or workspace. Do not send file contents unless requested through an approved channel.