# Media Upload

## Overview

HyperSkill allows adding media such as images, audio, and PDF documents to be used in their simulations. Authors must upload these files to their media repository before they can be added to  simulations. HyperSkill support the following media files.

### Images

Images can be attached to virtual object surfaces like a display monitor or a poster. Accepted files: .*jpg*, .*jpeg,* .*png*

### Audio

Audio can provide immersive sounds related to the simulation environment, or a more customized system sounds (chimes, alarms, etc.). Accepted files: .*wav*

### **Documents**

Documents uploaded to HyperSkill can be included as supplementary material (such as manuals or user guides) to assist learners with performing tasks in the simulation. Documents are also used in QA answering in **SimGPT**. Accepted files: .*pdf*

## How to Upload Media in HyperSkill

1. To access the media repository, click on the menu icon from the home page labeled **Media Library**.&#x20;

<figure><img src="/files/6PoFYaHBLat8uUqJsmAB" alt=""><figcaption></figcaption></figure>

Select between the tabs to upload images, audio files, or PDF documents.

<figure><img src="/files/tOvrzW9VWqM7KRcfpgxF" alt="" width="563"><figcaption></figcaption></figure>

3. Click on **+ New** and selected a file to upload.&#x20;

<figure><img src="/files/IRAnngXgv8R0a3Cx6UY6" alt="" width="563"><figcaption></figcaption></figure>

4. To delete an image, click on the **Trash** icon.&#x20;

## How to Upload Media in the web portal

1. To access the media repository, navigate to id.siminsights.com in your web browser. After login, click on "HyperSkill > Media"

<figure><img src="/files/nPOm1vFh4wJVv8yL8I1f" alt=""><figcaption></figcaption></figure>

1. Select between the tabs to upload images, audio files, or PDF documents.

<figure><img src="/files/OzhwSRXOQyJFdMybjE0V" alt=""><figcaption></figcaption></figure>

1. Click on **Upload** and drop a file to upload.&#x20;

<figure><img src="/files/b6kZ32qdJ2gB67aylVR9" alt=""><figcaption></figcaption></figure>

1. To delete an image, click on the **Trash** button.&#x20;

## Displaying Media in your Simulation

In order to display media in your simulation, you can use the **Display Image** state action and **Play Audio** state action. More information can be found in [Display Image](/authoring-a-simulation/state-machine/actions/display-image.md) and [Play Audio](/authoring-a-simulation/state-machine/actions/play-audio.md) documentation.&#x20;

<figure><img src="/files/oqH5ySkTSE4WA76Uloik" alt=""><figcaption><p>Display Image state action</p></figcaption></figure>

<figure><img src="/files/PjCc0eohIE0PtRSjUfHs" alt=""><figcaption><p>Play Audio state action</p></figcaption></figure>

## Adding Documents to your Simulation

To add documents to your simulation, navigate to **Settings**. Under **Global Settings**, click on **+ Add** next to **Documents**.&#x20;

<figure><img src="/files/xocqY5siZYltjsyaLgWI" alt="" width="354"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.siminsights.com/media-upload.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
