> 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 HyperSkill Platform

Your media is at [platform.siminsights.com/assets](https://platform.siminsights.com/assets), with your role set to Author. Choose the **Media** tab and press **Upload**. PNG, JPG, MP3, WAV, OGG and PDF files are accepted. Filter the list by **Images**, **Audio** or **Documents**, and download or delete a file from its row menu. See Your sims and assets.

{% hint style="warning" %}
Screenshot needed: Assets & Media on the Media tab with the Upload button.
{% endhint %}

## 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>
