# Assets

Source: https://docs.arcweave.com/project-items/assets/overview
Section: Project Items
Description: How to upload and use assets in Arcweave projects

**Assets** are media files you can upload to your Arcweave project to enrich the interactive experience with audiovisual elements. Arcweave supports the following asset types:

- [**Image assets**](https://docs.arcweave.com/project-items/assets/images): Used as covers for [elements](https://docs.arcweave.com/project-items/elements) and [components](https://docs.arcweave.com/project-items/components).
- [**Audio assets**](https://docs.arcweave.com/project-items/assets/audio): Attached to elements to play automatically in [Play Mode](https://docs.arcweave.com/project-tools/play-mode/overview), adding sound effects, background music, or narration.
- [**Video assets**](https://docs.arcweave.com/project-items/assets/video): Attached to elements to play automatically in Play Mode, enabling video sequences, visual storytelling, or interactive movies.

Assets help clarify your story, enhance immersion, and strengthen emotional impact.

## Assets section

Context: Arcweave docs > Project Items > Assets > Assets section

Inside any project, you can view and manage all uploaded assets and folders in the **Assets** section. This is located in the upper half of Arcweave's left sidebar, under the **Assets** tab.

![The Arcweave project environment with an orange rectangle emphasizing the Assets section of the left sidebar.](https://docs.arcweave.com/assets/assets-sidebar.CKLkshad.png)

## Asset folders

Context: Arcweave docs > Project Items > Assets > Asset folders

Arcweave allows you to create folders to organize your assets efficiently. You can build a custom folder structure to keep your project files clear and manageable.

## Upload assets

Context: Arcweave docs > Project Items > Assets > Upload assets

### From file manager

Context: Arcweave docs > Project Items > Assets > Upload assets > From file manager

The simplest way to upload assets is by dragging media files from your operating system's file manager into Arcweave's window. You can:

- **Drop anywhere**: Adds the files to the root of the [Assets section](https://docs.arcweave.com/project-items/assets/overview#assets-section).
- **Drop into a specific position**: Adds the files to a specific folder or position within the Assets list.

### From Assets section

Context: Arcweave docs > Project Items > Assets > Upload assets > From Assets section

You can also upload files directly within the **Assets** section using the **Upload assets...** options.

#### Upload assets to the top of the Assets section

Context: Arcweave docs > Project Items > Assets > Upload assets > From Assets section > Upload assets to the top of the Assets section

To upload a new asset at the top of your **Assets** list:

1. In the **Assets** section header, click **Create asset** (image icon with a plus).
2. Select **Upload assets...**.
3. Select one or more files from your device.

#### Upload assets to the bottom of the Assets section

Context: Arcweave docs > Project Items > Assets > Upload assets > From Assets section > Upload assets to the bottom of the Assets section

To upload a new asset at the bottom of your **Assets** list:

1. Right-click an empty area in the **Assets** section.
2. Select **Upload assets...**.
3. Select one or more files from your device.

#### Upload assets above existing assets

Context: Arcweave docs > Project Items > Assets > Upload assets > From Assets section > Upload assets above existing assets

To upload a new asset above an existing one:

- Right-click the existing asset's name.
- Select **Upload assets...** from the menu.

Or:

- Hover the mouse cursor over the existing asset's name.
- Click the **(+) icon** that appears.
- Select **Upload assets...** from the menu.

#### Upload assets into existing folders

Context: Arcweave docs > Project Items > Assets > Upload assets > From Assets section > Upload assets into existing folders

To upload a new asset inside a folder:

- Right-click the folder's name.
- Select **Upload assets...** from the menu.

Or:

- Hover the mouse cursor over the folder's name.
- Click the **(+) icon** that appears.
- Select **Upload assets...**.

### Asset upload limits

Context: Arcweave docs > Project Items > Assets > Upload assets > Asset upload limits

Each workspace plan includes specific file sizes and storage limits:

| Plan      | Max file size | Total storage per project |
| --------- | ------------: | ------------------------: |
| **Basic** |          5 MB |                     50 MB |
| **Pro**   |        100 MB |                      1 GB |
| **Team**  |        400 MB |                     10 GB |

> ⚠️ **If I downgrade my plan, what happens to my assets?** Existing assets remain in your project. New uploads must fit the new plan's limits: each file must be within the maximum file size, and the project's total asset storage, including existing assets, must stay within the plan's limit. See [Downgrade to Basic](https://docs.arcweave.com/workspaces/billing-plans#downgrade-to-basic) in the Workspace plans page.

## Replace assets

Context: Arcweave docs > Project Items > Assets > Replace assets

You can replace an existing asset with a new file. Arcweave automatically updates all instances of that asset throughout the project, saving you from manually reassigning it.

To replace an asset:

1. In the **Assets** section, right-click the asset you want to replace.
2. Select **Replace asset...**.
3. Select a new file from your device.

## Generate image asset

Context: Arcweave docs > Project Items > Assets > Generate image asset

![Arcweave's project environment, showing the context menu in the assets section (revealed by right-clicking an asset). An orange rectangle emphasizes the option to Generate asset.](https://docs.arcweave.com/assets/assets-generate-image.wS1dcQGR.png)

You can use Arcweave's [Image Generator](https://docs.arcweave.com/project-tools/ai-features/image-generator) to generate image assets. See [Image Generator: Use from the Assets section](https://docs.arcweave.com/project-tools/ai-features/image-generator#use-from-the-assets-section) for instructions.

## Create folders

Context: Arcweave docs > Project Items > Assets > Create folders

### From Assets section

Context: Arcweave docs > Project Items > Assets > Create folders > From Assets section

You can create asset folders directly from your project's **Assets** section.

#### Create a folder at the top of the Assets section

Context: Arcweave docs > Project Items > Assets > Create folders > From Assets section > Create a folder at the top of the Assets section

In the **Assets** section header, click **Create folder** (**folder** icon).

#### Create a folder at the bottom of the Assets section

Context: Arcweave docs > Project Items > Assets > Create folders > From Assets section > Create a folder at the bottom of the Assets section

1. Right-click an empty area in the **Assets** section.
2. Select **Create folder**.

#### Create a folder above an existing asset

Context: Arcweave docs > Project Items > Assets > Create folders > From Assets section > Create a folder above an existing asset

- Right-click the asset's name.
- Select **Create folder** from the menu.

Or:

- Hover the mouse cursor over the asset's name.
- Click the **(+) icon** that appears.
- Select **Create folder**.

#### Create a subfolder inside an existing folder

Context: Arcweave docs > Project Items > Assets > Create folders > From Assets section > Create a subfolder inside an existing folder

- Right-click the folder's name.
- Select **Create folder** from the menu.

Or:

- Hover the mouse cursor over the folder's name.
- Click the **(+) icon** that appears.
- Select **Create folder**.

## Rename assets or folders

Context: Arcweave docs > Project Items > Assets > Rename assets or folders

To rename an asset or folder:

1. Open the **Assets** section.
2. Right-click the asset or folder.
3. Select **Rename**.

## Asset references

Context: Arcweave docs > Project Items > Assets > Asset references

Arcweave provides easy access to an asset's **references**: the instances of the asset that are attached to elements or components.

To access an asset's references:

1. Right-click the asset in the **Assets** section.
2. Select **References...**.

![Asset context menu with the References option highlighted.](https://docs.arcweave.com/assets/assets-references-menu.bTrx5lnq.png)

In the modal that opens, you will see all references of the asset in elements (as a cover, audio attachment, or Asset List item) and components (as a cover or Asset List item). To visit any of the referenced elements or components, **click on the reference**.

![Asset references modal showing where an asset is used in the project.](https://docs.arcweave.com/assets/assets-references-modal.BjDlFNks.png)

> ✅ Use the modal's left sidebar to view all references or to filter the ones in elements or components.

## Delete assets or folders

Context: Arcweave docs > Project Items > Assets > Delete assets or folders

To delete an asset or folder:

1. Open the **Assets** section.
2. Right-click the asset or folder.
3. Select **Delete**.

> ℹ️ Deleting an asset removes all its instances from elements and components.

> ⚠️ Deleting a folder also deletes all assets and subfolders contained within it.

## Preview assets

Context: Arcweave docs > Project Items > Assets > Preview assets

To preview an asset, click it in the **Assets** section.
Each asset type has its own preview interface: see [image](https://docs.arcweave.com/project-items/assets/images#preview-image-assets), [audio](https://docs.arcweave.com/project-items/assets/audio#preview-audio-assets), and [video](https://docs.arcweave.com/project-items/assets/video#preview-video-assets) documentation for details.

## Use assets

Context: Arcweave docs > Project Items > Assets > Use assets

After uploading, you can use assets in the following ways:

- **Image assets**: Set as covers for [elements](https://docs.arcweave.com/project-items/elements#element-covers) or [components](https://docs.arcweave.com/project-items/components#cover).
- **Audio assets**: Attach to [elements](https://docs.arcweave.com/project-items/elements#audio-attachments) to play automatically in Play Mode.
- **Video assets**: Set as covers for [elements](https://docs.arcweave.com/project-items/elements#element-covers) to play in Play Mode.