> For the complete documentation index, see [llms.txt](https://docs.siminsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siminsights.com/hyperskill-studio-authoring/media.md).

# Media

Upload images, audio and PDFs, and use them inside a simulation.

## 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 supports 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 more customized system sounds (chimes, alarms, etc.). Accepted files: .wav, .mp3, .ogg

### 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 PDF question answering by AI Chat. Accepted files: .pdf

## How to upload media in HyperSkill Studio

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

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2F6WyBc1aiavJVkE4FW4Ld%2Fimage.png?alt=media&#x26;token=9bd66d6e-4e97-470b-b27a-ebf7ced63464" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FcvegIHkRhGHmIF4Y5B8N%2Fimage.png?alt=media&#x26;token=f5ac9235-2921-46ca-9303-c3fab5779580" alt="" width="563"><figcaption></figcaption></figure>

3. Click on **+ New** and select a file to upload.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2Fmb6cOa94dU25LNV3DPeU%2Fimage.png?alt=media&#x26;token=4d2cc2cd-7cea-45ef-ac1f-81a267dde3f6" alt="" width="563"><figcaption></figcaption></figure>

4. To delete an image, click on the **Trash** icon.

## How to upload media in the HyperSkill web app

In the HyperSkill web app at [hyperskill.siminsights.com](https://hyperskill.siminsights.com/):

1. Click the **Assets** button in the left sidebar to open the asset tab.
2. Click **Upload New** at the top right. This opens a floating panel.
3. In the floating panel, choose the file to upload.

![The upload panel (shown here for a virtual object): enter an asset name and choose the file](https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FnL2Hfv8VK7VelPZGWVve%2Fupload%20media.png?alt=media\&token=2ef348a8-78f0-4e73-be48-16243c51048a)

PNG, JPG, MP3, WAV, OGG and PDF files are accepted for media. See [Your sims and assets](https://docs.siminsights.com/hyperskill-studio-authoring/your-sims-and-assets).

## 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. See Display Image and Play Audio.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FF5QQ1fqS29xUFizrM1em%2Fimage.png?alt=media&#x26;token=337fa1d8-7e3b-4ba9-846f-f2e0a752bd36" alt=""><figcaption><p>Display Image state action</p></figcaption></figure>

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FyVLjmwqioexUPVk5zVS6%2Fimage.png?alt=media&#x26;token=998e1075-ef7b-4036-8dfa-34bb24766c8d" 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**.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FKWbyHE6RJERsIPtdJ9f9%2Fimage.png?alt=media&#x26;token=09a23ad4-ec08-4541-b573-239997640999" alt="" width="354"><figcaption></figcaption></figure>
