> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wejam.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Attaching Supplementary Materials to a Mission

> Give learners up to five files or links on a mission briefing, in the order they should read them.

## Overview

Each mission can show learners up to 5 supplementary materials - files and links they open on the briefing screen under **Supplementary Material** before they start the call. You pick them on the **Advanced** tab of the [mission editor](https://docs.wejam.ai/external/studio/creating-a-mission.md), next to **Scenario**, **Persona**, and **Scorecard**. The materials themselves live in your organization's library on [Context & Documents](https://docs.wejam.ai/external/studio/managing-supplementary-materials.md), so one price list can serve every mission that needs it.

## Before you start

* You need the **Editor** or **Admin** [role](https://docs.wejam.ai/external/admin/assigning-roles.md). Other roles don't see the **Advanced** tab.

## Attaching materials from your library

Open the mission in the editor, switch to **Advanced**, and click **Attach existing**. Search or pick from your organization's materials - ones already on this mission aren't offered again - then click **Attach**. The dialog tells you how many more you can add, and the counter on the tab (for example **2 of 5 attached**) keeps track.

## Creating a material while you edit

Don't have the file in your library yet? Click **Create new** to open the same **Add learner material** dialog used on Context & Documents. Upload a file or paste an `https://` link, give it a title, and click **Add**. The material is attached to this mission straight away and also added to your library, ready for other missions. The [upload rules](https://docs.wejam.ai/external/studio/managing-supplementary-materials.md#adding-a-file-or-link) are the same in both places.

## Removing and reordering materials

Learners see the materials in the order listed here. Drag a material by its handle to move it up or down.

Click **Remove** to take a material off this mission. It stays in your library on [Context & Documents](https://app.wejam.ai/studio/context-documents?activeTab=learner-materials) and on any other missions that use it - to delete it everywhere, [delete it from the library](https://docs.wejam.ai/external/studio/managing-supplementary-materials.md#deleting-a-material).

## Staying within the 5-material limit

Once a mission has 5 materials, **Attach existing** and **Create new** are disabled until you remove one. Some older missions may already carry more than 5. They keep all of them until you remove some, and you can attach new ones again once the mission is below 5.

## When learners see your changes

Your changes show in the editor's preview right away. After you save the mission, learners see them at once if the track is published; otherwise they appear once you [publish the track](https://docs.wejam.ai/external/studio/creating-publishing-tracks.md#publishing).

## What happens next

* Learners click a material on the briefing screen to open it in a new browser tab; hovering shows its description. See [Starting and Completing a Roleplay](https://docs.wejam.ai/external/coaching/roleplay.md#preparing-the-mission-briefing).
* Once you save, the material's **Used in** count on Context & Documents includes this mission.
* Editing a material in the library updates it on this mission too - no need to re-attach it.

## Troubleshooting

> [accordion] A material shows as Unavailable material
>
> The material was deleted from the library or isn't available to your
> organization. Click **Remove** to clear it from the mission, then attach a
> replacement.

> [accordion] The Advanced tab says materials can't be attached here
>
> Materials can only be attached to missions in your organization's own
> editable content. This mission belongs to a different content library, so
> its materials can't be changed from your organization.

> [accordion] The list says No learner materials left to attach
>
> Your library is empty, or every material in it is already on this mission. Use **Create
> new** to add another, or [add it on Context &
> Documents](https://docs.wejam.ai/external/studio/managing-supplementary-materials.md#adding-a-file-or-link)
> first.

## Related articles

* [Adding Supplementary Materials for Learners](https://docs.wejam.ai/external/studio/managing-supplementary-materials.md) - manage the shared library and its upload rules
* [Creating a Mission in Jam Studio](https://docs.wejam.ai/external/studio/creating-a-mission.md) - the rest of the mission editor
* [Creating and Publishing a Track](https://docs.wejam.ai/external/studio/creating-publishing-tracks.md) - when your saved changes reach learners
* [Starting and Completing a Roleplay](https://docs.wejam.ai/external/coaching/roleplay.md) - the briefing screen from the learner's seat

***

*Last updated: November 2026*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.