> For the complete documentation index, see [llms.txt](https://helpdocs.conducttr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdocs.conducttr.com/feature-documentation/designing-and-running/channels/pop-up-channels/media-pop-up.md).

# Media pop-up

Media pop-up is a channel you can use to make an **image or video "pop-up" and appear on the player's screen**.

| Benefit                                                                              | Feature                                                                                                                                                         |
| ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Grab players' attention immediately regardless of which channel they're currently in | <ul><li>Stream video (which rate-adapts with poor connections)</li><li>Add an image overlay to extend the utility of videos</li><li>Add a news ticker</li></ul> |

## Running

<figure><img src="https://3476309720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsNKxYbIPgfYmCR9EJgAu%2Fuploads%2Fja8MRSxDsyq8F4DCC1Xv%2Fmedia%20pop-up.png?alt=media&amp;token=c9acaf8e-ac8c-49c5-8871-9554d63cbbe9" alt=""><figcaption><p>This is what a media pop-up looks like for players (with news ticker text)</p></figcaption></figure>

***

## Designing

### How to (Injects)

Within the inject, click on `Please add video or image` to import it through your media library.

Alternatively, drag and drop the media you want.

<figure><img src="https://3476309720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsNKxYbIPgfYmCR9EJgAu%2Fuploads%2FHbDvrVmrQ8kHyIPEQ2xb%2Fmedia%20pop-up.gif?alt=media&amp;token=1c49e1de-12b1-4cfa-98db-480c97ed55c9" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="160">Options</th><th>Description</th></tr></thead><tbody><tr><td><strong>Timer</strong></td><td>Select the amount of time you want the image/video to stay on the screen for.<br><strong>Video:</strong> the default timer length for videos is the length of the clip. But If you have a long video, you might want to use a shorter duration for the timer so players aren't interrupted for the whole video.<br><strong>Image:</strong> the default timer length for images is 10 seconds. You can extend this by editing the timer.</td></tr><tr><td><strong>News ticker text</strong></td><td>This is the text that scrolls across the bottom of a video like a news ticker.<br>You can use the toggle button to select the direction in which the banner moves (used for different languages that may read right to left instead of left to right)</td></tr><tr><td><strong>Overlaid image</strong></td><td>Overlay an image on the video and set the start time and duration.</td></tr></tbody></table>

{% hint style="success" %}
Using the news ticker and overlaid mage on a video media pop-up allows you to get greater use of "generic" video content by making it appear bespoke to an exercise. E.g. a video about a flood can now appear to be about a flood in a specific area / affecting these peopl&#x65;*.*
{% endhint %}

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FlJakpmlu5TTy4SjsdInt%252Fimage.png%3Falt%3Dmedia%26token%3D1892f652-58da-4860-86d7-b1060bde30a9&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=c34c3f9&#x26;sv=2" alt=""><figcaption></figcaption></figure>

### :star:Best practices <a href="#faqs-and-tips-for-media-pop-up" id="faqs-and-tips-for-media-pop-up"></a>

* Use media pop-ups sparingly to create spectacle
* Remember your exercises should be participatory and that media pop-ups interrupt the player's current activity. Use it when you need to grab attention!&#x20;
* Use shorter videos for media pop-ups to maintain player engagement
* We recommend using images with dimensions of roughly 2000 x 3800px for the best output


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpdocs.conducttr.com/feature-documentation/designing-and-running/channels/pop-up-channels/media-pop-up.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
