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

# Adding Supplementary Materials for Learners

> Upload files and links your learners can open before a mission, and keep that shared library up to date.

## Overview

Supplementary materials are files and links your learners open on a mission's briefing screen, under **Supplementary Material** - a product sheet, a price list, a policy page. You keep them in one library on [Context & Documents](https://app.wejam.ai/studio/context-documents?activeTab=learner-materials) (under **Create** in the sidebar), then [attach them to missions](https://docs.wejam.ai/external/studio/attaching-supplementary-materials.md) in the mission editor. One material can serve as many missions as you like.

## 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 **Supplementary materials** tab.

## Choosing the right tab

Context & Documents holds two kinds of documents with different jobs, each on its own tab:

* **AI context documents** are for the AI only. It reads them, together with your organization description and website, when it [customizes tracks](https://docs.wejam.ai/external/studio/creating-publishing-tracks.md). Learners never see them.
* **Supplementary materials** are for learners only. They appear on the briefing screen of every mission they're attached to, and the AI does not read them.

Want the AI to know your product range? Use **AI context documents**. Want learners to have the price list open during practice? Use **Supplementary materials**. If you need both, upload the file on both tabs.

## Adding a file or link

Open the **Supplementary materials** tab and click **Add learner material**. Under **Type**, choose **File** or **Link**:

* For a file, drop it on the upload area or click **Browse files**. Supported formats are PDF, DOCX, PPTX, XLSX, TXT, CSV, PNG, and JPEG, up to 10 MB per file.
* For a link, paste the address into **URL**. It must start with `https://`. Learners open links in a new browser tab.

Give the material a **Title** (up to 200 characters) and, if it helps, a **Description (optional)** of up to 1,000 characters, then click **Add**. Choose a title learners will recognize: it's the label they click on the briefing screen, and the description shows when they hover over it.

The table lists every material with its type (for example **File · PDF** or **External URL**) and a **Used in** count of the missions it's attached to. **Not used** means no mission shows it yet.

## Editing a material

Click the pencil next to a material to open **Edit learner material**. You can change the title and description, swap a file with the upload icon next to the current file, or change a link's URL, then click **Save**. Every mission that uses the material shows the updated version - there's no need to re-attach it. You can't turn a file into a link or the other way round; add a new material instead.

## Deleting a material

Click the bin next to a material and confirm with **Delete**. If missions still use it, the dialog lists them first, because learners will no longer see the material on any of those missions.

> [!WARNING]
>
> Deleting removes the material from every mission it's attached to. To take
> it off a single mission only, [remove it in the mission
> editor](https://docs.wejam.ai/external/studio/attaching-supplementary-materials.md#removing-and-reordering-materials)
> instead.

## What happens next

* A new material shows **Not used** until you [attach it to a mission](https://docs.wejam.ai/external/studio/attaching-supplementary-materials.md) - each mission takes up to 5.
* Learners see it on the mission's [briefing screen](https://docs.wejam.ai/external/coaching/roleplay.md) once the mission is saved and its track is published.
* Updating your organization's AI context instead? Stay on **AI context documents** - the [track customization wizard](https://docs.wejam.ai/external/studio/creating-publishing-tracks.md) draws on those.

## Troubleshooting

> [accordion] My file won't upload
>
> Check the format and size: only PDF, DOCX, PPTX, XLSX, TXT, CSV, PNG, and
> JPEG files up to 10 MB are accepted. Convert other formats (for example a
> .doc or .key file) to PDF first.

> [accordion] My link is rejected
>
> Links must be full addresses starting with `https://`. Copy the address
> straight from your browser's address bar rather than typing it.

> [accordion] I don't see the Supplementary materials tab
>
> The tab is only visible to Editors and Admins. Ask an Admin to [change your
> role](https://docs.wejam.ai/external/admin/assigning-roles.md) if you need to
> manage materials.

## Related articles

* [Attaching Supplementary Materials to a Mission](https://docs.wejam.ai/external/studio/attaching-supplementary-materials.md) - put materials in front of learners
* [Creating a Mission in Jam Studio](https://docs.wejam.ai/external/studio/creating-a-mission.md) - the mission editor where you attach them
* [Creating and Publishing a Track](https://docs.wejam.ai/external/studio/creating-publishing-tracks.md) - how AI context documents shape customized tracks
* [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.