# Uploading and using your assets

You can import the following types of files into ShapesXR:

* **PNG** and **JPG** for images.
* **OBJ**, **GLB**, **glTF (as ZIP),** and **STL** for 3D models.
* **MP3** and **WAV** for sounds.
* **MP4** for videos.
* [**Figma** **files**](https://learn.shapesxr.com/import/figma-integration).
* [**Figma prototypes**](https://learn.shapesxr.com/import/figma-integration#figma-playable-prototype).
* [**YouTube videos**](https://learn.shapesxr.com/import/youtube-integration).

## How to upload your files

1. Sign in with your Shapes account in the [Dashboard](https://shapes.app/spaces/recent).
2. Go to the [My Files](https://shapes.app/files) section.
3. Drag & drop your files or use the Import button to load needed files to the cloud storage.

<figure><img src="https://1564817110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FQj83LNhxbJmxGNgKJJJX%2FScreenRecording2024-07-17at10.51.53.gif?alt=media&#x26;token=49efc3e1-6cdc-4688-8a09-650eff7951d3" alt=""><figcaption><p>Drag &#x26; drop files into the Dashboard</p></figcaption></figure>

<figure><img src="https://1564817110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FqziG4NeTlUeD2FF3aJNM%2FScreenshot%202025-10-21%20at%2014.44.18.png?alt=media&#x26;token=28f8b1ec-d5a0-4f93-9c0f-e5dfacebdd8f" alt=""><figcaption><p>Import button</p></figcaption></figure>

## Working with imported files in the Dashboard

Click on any file so the options will be shown - you can download, duplicate, rename, and remove your resources.

To completely delete any file or clean the storage, be sure that files are also deleted from the Trash.

#### File management (folders)

Create [folders](#file-management-folders) and manage your assets in the app and the Dashboard.&#x20;

## Working with imported files in VR

After you’ve successfully uploaded your files through the Dashboard, you can use them in VR - go to any space, open the Assets menu -> My Files, hover over an asset in the list, and grab it with the grip button to set it in the space.

#### Preview window

You can preview images, Figma files, and 3D models in VR. Click on the resource with the trigger button to open the preview window.

You can grab your asset from the preview and set it in the space.&#x20;

<figure><img src="https://1564817110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FfnGj5adWAZuq4dHro1sO%2Fcom.Tvori.Shapes-20250128-141932-0-ezgif.com-optimize.gif?alt=media&#x26;token=dab6369b-8385-48a1-911f-58fb78341653" alt=""><figcaption></figcaption></figure>

**3D Model preview**

For models, you can set the scale and spawn the model with this scale in the center of the space.

<figure><img src="https://1564817110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FImOboXQ4e9IcLYysuI2m%2Fscalemodels.gif?alt=media&#x26;token=bedc572b-0771-46df-bdfc-ea9272869aa4" alt=""><figcaption></figcaption></figure>

**Image/Figma preview**

For images and [Figma files](https://learn.shapesxr.com/import/figma-integration), you can set transparency (modes are different for JPEG and PNG/Figma files because of the alpha-channel specifics), scale by distance (UI), and distance.\
\
The Figma file's preview has the Sync button that refreshes this Figma file.

<figure><img src="https://1564817110-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FpAuaN5v1pWQvXm4TJTsb%2F43476789-ezgif.com-optimize.gif?alt=media&#x26;token=286e6e70-648e-4f9d-85d6-d20557170b3f" alt=""><figcaption></figcaption></figure>

### Working with sounds&#x20;

Read more about using sound files in **Play sound interactivity** here - [How to prototype with sounds](https://learn.shapesxr.com/prototyping/how-to-prototype-with-sounds).

### Working with MP4 videos

Open **My Files** and drag the video file into your scene using the grip button.

To select the video, click the bar beneath it to open the Object Inspector. From there, you can start previewing the video, adjust the volume, and enable Autoplay and Loop settings, which apply in Play mode.

Click a video to play or pause it in both edit and Play mode.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV5IFh3rk5kqfCwJPPYhE%2Fuploads%2FsdfSH9TcySKHO9FLBPpd%2Fmp4%20video%202.mp4?alt=media&token=30365cce-0ef7-4ee2-8e22-d43c0bed3231>" %}

**Limitations & Recommendations**

For optimal performance, use the following video format:

* **Codec:** H.264 (video) + AAC (audio)
* **Container:** MP4
* **Bitrate:** 2–5 Mbps for 1080p

If you experience performance issues, reduce the video resolution to 720p or 480p, especially when the video is not displayed in full screen.

## How to replace your files

You can replace an existing image or 3D model with a new file.

1. Open the **Dashboard** and go to **My Files**.
2. Select the file you want to replace.
3. Click **Replace**, then choose a new file with the same format as the original.
4. Once the upload is complete, all instances of the original file in your spaces will automatically update to the new version.