For the complete documentation index, see llms.txt. This page is also available as Markdown.

Uploading and using your assets

You can import the following types of files into ShapesXR:

How to upload your files

  1. Sign in with your Shapes account in the Dashboard.

  2. Go to the My Files section.

  3. Drag & drop your files or use the Import button to load needed files to the cloud storage.

Drag & drop files into the Dashboard
Import button

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 and manage your assets in the app and the Dashboard.

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.

3D Model preview

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

Image/Figma preview

For images and Figma files, 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.

Working with sounds

Read more about using sound files in Play sound interactivity here - 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.

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.

Chroma key for MP4 videos

You can enable chroma keying for your videos by using a chroma color. Upload the video to ShapesXR, add it to your scene, then select it from the bottom bar. Turn on the Chroma Keying option and choose the same color as the video’s background.

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.

Last updated