Overview
Most authored actions in Creator App refer to a piece of media — a panel shows an image, a step plays a video, a narration uses an audio clip, a scene includes a 3D object. Media Upload is how you get those files into the training. Creator App uploads media per action: wherever an action has a media field, it also offers an Upload button. Uploads go straight to the asset library and are immediately available for reuse in any other action in the same organisation.Where You Upload Media
Media upload controls appear in any action parameter panel that accepts a media file:| Action | Media field | Upload label |
|---|---|---|
| Show Panel | Image / Video / Audio | Select image file / Select video file / Select audio file + Upload |
| Show Image | Image | Select image + Upload Image |
| Play Video | Video Asset | Select video + Upload |
| Play Audio | Audio Asset | Select from library (for uploads, use an action above that has an Upload button, or upload inside a Show Panel) |
| Add Object | 3D Object | Select 3D Object + Upload |
Supported Formats
| Type | Accepted file extensions |
|---|---|
| Image | .jpg, .jpeg, .png |
| Video | .mp4 |
| Audio | .mp3, .wav, .ogg |
| 3D Model | .glb |
Uploading a File
Open an action that accepts media
For example, add a Show Panel action and expand its Media Panel section.
Choose the media type
Select Show Image, Show Video, or Audio (for Show Panel), or use the dedicated media field in actions like Play Video or Add Object.
Click Upload
Click the Upload button next to the media field. Your operating system’s file picker opens, filtered to the accepted extensions.
Pick your file
Choose the file and confirm. Creator App shows the upload progress on the button:
| State | Label |
|---|---|
| Reading / thumbnailing | Processing… |
| Uploading | Uploading % (0 – 100) |
| Finishing | Finalizing… |
| Done | Complete! |
| Failed | Failed - Retry? (hover for the error) |
Drag and Drop
The Show Panel editable preview (when you open a panel in the 3D viewer) supports drag-and-drop from the asset library:- Image / video field: Drop image/video from library or click to upload
- Audio field: Drop audio from library or click to upload
Asset Library
After upload, files appear in the organisation’s asset library and can be reused in any training. Open the Assets panel (sidebar tab) to browse existing assets. The panel has three tabs:| Tab | Assets |
|---|---|
| Audio | .mp3, .wav, .ogg |
| Images | .jpg, .jpeg, .png |
| Videos | .mp4 |
3D models are listed separately. Add Object opens the 3D model picker; the static object catalog on the left of the authoring page is a separate, local catalog of objects shipped with Altoura.
Behind the Scenes
When you upload a media file, Creator App:- Validates the extension against the accepted list for the control.
- Processes the file (for images and videos, a thumbnail is generated; for non-GLB 3D meshes, the asset processor converts them to GLB before upload).
- Requests a SAS token from the server so it can upload directly to Azure Blob Storage.
- Uploads the file with progress reported back to the button.
- Uploads an associated
_thumb.pngwhen a thumbnail exists. - Registers the asset in your organisation by calling the assets API.
- Attaches the new asset’s GUID and version to the action parameter so the action now references the uploaded file.
Common Upload Errors
| Error | Meaning |
|---|---|
| Unsupported file type. Allowed: … | The file extension does not match the accepted list for that control |
| No organization ID available | Your session does not have an organisation context; sign out and sign back in |
| Upload failed | Network or server error during the upload; retry using Failed - Retry? |
| Asset created but could not be retrieved | Backend registered the asset but the follow-up fetch failed; refresh the page and the asset should appear |
| Upload succeeded but UI update failed. Please refresh the page. | Rare race condition; refresh and the asset will be in the library |
Best Practices
Compress before upload
Shrink images and videos to the smallest size that still looks good. Large files slow learners’ load times, especially on mobile.
Name files clearly
Before uploading, rename your file to something descriptive (for example
engine-oil-cap-close-up.jpg). The filename becomes the default asset name in the library.Use tags to organise
After upload, apply tags to the asset in the library so reviewers can find it by
training-name, scene, or topic.Convert unusual formats in advance
.mov, .webm, .aac, and similar formats are not accepted by the file picker. Convert to .mp4 (video) or .mp3 (audio) first.Test 3D models in a throwaway step first
GLBs vary wildly in complexity. Upload to a test state first and check performance before attaching the model to the production flow.
Limitations
- No bulk upload — Files are uploaded one at a time per action field.
- No folders — Assets are organised by type and tags, not by folder hierarchy.
- No in-app trimming or cropping — Edit media before upload.
- File size limits are enforced server-side — The client does not show a size cap, but the server may reject very large files. Compress before uploading if possible.
Related
- Show Panel — The action with the most upload controls (image, video, audio all in one panel)
- Play Video — Upload a video to attach to a Play Video action
- Play Audio — Play back audio uploaded via Show Panel or other upload paths
- Add Object — Upload a
.glb3D model for a scene - Text-to-Speech — An alternative way to produce narration without uploading an audio file