Skip to main content

Manage media content

Upload, find and reuse images, video, audio and documents, choose who can see each file, and set up audio avatars and subtitles.

Written by Cody Iddings

The media library

The media library is your central hub for managing all media content in Makeshapes.

How to open the media library

From anywhere in the app:

  • Click Media in the sidebar

    The sidebar of the creator app, with Media highlighted.
  • Or visit directly at /media-library

When building an experience:

  • Click any "Choose [media type]" button (for example, "Choose video", "Choose audio", "Choose image")

  • Or drag and drop a file directly onto any empty media selector to upload and attach it

What's in the media library?

Depending on the media type you're working with, the media library can show these tabs:

  • Media library - Browse and manage all your media with powerful filters

  • Royalty-free images / Royalty-free audio - Browse free-to-use images (from Unsplash) and background audio

The ways to add something new are on the Add media menu. When there's only one way, it's an Upload files button instead:

  • Upload files - Upload new files from your computer (or drag and drop anywhere!)

  • Record audio - Record audio directly in your browser

  • Text-to-speech - Generate AI voiceovers from text (audio only)

  • YouTube or Vimeo link - Add videos from external platforms (video only)

Finding your media

Search

Type in the search box to find media by name. Search updates as you type.

Filter by scope

In the Library list, choose what media to see:

  • Organisation library - Every file you can see, whoever uploaded it

  • My uploads - Only media you've uploaded

  • A project's name, under Projects - Only the files limited to that project. The list is headed "Limited to" and the project's name. A small mark on a file shows it's limited. Point to the mark to see "Limited to" and the project names. Files with no mark are visible to everyone. You see only your own projects here

    The Media page with the Library list open, showing Organisation library, My uploads and the projects under Projects.
    The Media page showing the Safety incidents project, with the small project mark on its files highlighted.

For more about who can see a file, see Manage projects.

Filter by usage (when building an experience)

See where media is being used:

  • All assets - Every file you can see, used or not

  • Assets used in this project - Files that belong to the current project, and files used anywhere in it

  • Assets used in [Experience Name] - Media used in this experience, whether or not it's published

Filter by type

Use the type icons in the toolbar to show only images, video, audio or documents. With no type selected, you see everything.

  • Images - JPG, PNG, GIF, WebP and SVG files

  • Video - Uploaded videos, YouTube and Vimeo

  • Audio - MP3, WAV, OGG, AAC and M4A files, and text-to-speech audio

  • Documents - PDFs

Sort

Organize your media with the Sort list, by date uploaded or by name:

  • Newest

  • Oldest

  • Name, A to Z

  • Name, Z to A

Grid and list view

To switch between grid and list view, use the Grid view and List view buttons in the toolbar. Grid view shows media as thumbnails, while list view shows a compact row with thumbnail, name, and type information. Your view preference is saved across sessions.

Who can see a file

A file is visible to everyone in your company, or limited to one or more projects. A limited file is visible only to those projects' members, and admins. Existing files stay visible to everyone until someone limits them.

All access means everyone. It's also the name for experiences that belong to no project.

Where new files go

A file you upload, record, link or make with text-to-speech inside an experience that belongs to a project goes to that project only. Files you add on the Media page, or in an experience in All access, go to everyone. A language version of a file follows the original.

Upload files says where your files will go: the project's name, or All access.

The Upload files step opened from an experience in Onboarding, with Onboarding highlighted as where the files will go.

See who can see a file

  1. Click Media in the sidebar, and then click the file.

  2. In the file's details, read the Visibility section.

    A file's details, with the Visibility section highlighted, showing the project the file is limited to.

It shows All access with "Everyone in" and your company's name, or the projects the file is limited to. You see only the projects you're in, so a file can be visible to more projects than the section lists. A language version shows Follows the main file.

Change who can see a file

Admins, and people who can edit every project the file is in, see a Change access button in the Visibility section. A language version always follows its main file, so you change the original.

  1. In the Visibility section, click Change access.

  2. Under Who can see this file, choose All access or Only these projects.

    The Change access dialog, with Only these projects chosen and a project ticked.
  3. If you chose Only these projects, select the projects under Projects.

  4. Click Save changes. To reverse it, click Undo in the "Access changed" message.

The dialog stops a change that would leave an experience without its file:

  • Only these projects is unavailable while an experience in All access uses the file. It says "Used by an experience in All access".

  • A project whose experience uses the file stays selected. It says, for example, "Used by 2 experiences in Safety incidents".

  • A file needs at least one project when it isn't in All access.

You change one file at a time. There's no way to limit several files at once.

Add a file from elsewhere to an experience

When you add a file that the experience's project can't see yet, Makeshapes asks first, for example "Make this file visible to Onboarding?". Click Make visible and add to confirm. The project can see the file from then on, even if you later remove it from the experience.

The Make this file visible to Onboarding? question, with Make visible and add highlighted.

If only an admin can widen the file's visibility, nothing is added. The message begins "Only an admin can make this file visible to" and says "Nothing was added."

Files you can't see

If an experience uses a file you can't see, the slot says "Image not found", or the same for audio, video or a document. Click it to choose another file. A live session still plays the file.

Add videos to your experience

Videos are used as rich media content to enhance your learning experience. You can upload videos directly to our platform or add URLs for videos hosted on YouTube or Vimeo.

How to add a video

  1. Add a Video activity to your desired section

  2. Click Choose video

  3. Choose from three options:

Upload a video

  • Click Add media, and then click Upload files (or drag and drop your file anywhere!)

  • Select your video file (MP4, MOV, WebM or M4V)

  • The video will upload and process automatically in the background

  • Optional: to rename it, click it on the Media page and change Name

  • You can navigate away during upload - it will continue in the background

  • If you try to close the page during upload, you'll see a warning

  • Once processing completes, it will appear in your media library

Add from YouTube

  • Click Add media, and then click YouTube or Vimeo link

  • Copy the full YouTube URL (for example, https://www.youtube.com/watch?v=dQw4w9WgXcQ )

  • Paste it into the URL field

  • Click Add to media library

    The YouTube or Vimeo link step with a video found, and the Add to media library button highlighted.
  • Click Add to experience

  • Your video must be set to Public or Unlisted (not Private) in YouTube Studio

Add from Vimeo

  • Click Add media, and then click YouTube or Vimeo link

  • Copy the Vimeo URL with just the video ID (for example, https://vimeo.com/140655611 )

  • Paste it into the URL field

  • Click Add to media library

    The YouTube or Vimeo link step with a video found, and the Add to media library button highlighted.
  • Click Add to experience

  • For paid Vimeo accounts: Set privacy to Public or Hide from Vimeo

  • For free accounts: Set to Public

Subtitles and captions

Add subtitles to your videos for accessibility:

  • Uploaded videos: To upload subtitles, click the video on the Media page to open its details. In the Subtitles section, click Add subtitles (or Upload a subtitle file), and then choose a subtitle file (VTT format only, max 5MB). You can add a track for each language. See Subtitles.

  • YouTube videos: Subtitles are not available for YouTube videos in Makeshapes. To add subtitles, upload your video directly.

  • Vimeo videos: Manage subtitles in your Vimeo account. Note that Vimeo subtitles may display with different styling. For the best subtitle experience, upload your video directly to Makeshapes.

Video duration

The duration is automatically calculated and displayed. For uploaded videos, this happens after processing completes.

Add images to your experience

Images are often used as content on the group display when there isn't an interactive activity. You can also use images and audio together with the Slideshow activity.

How to add images

When you see a Choose image button:

Upload an image

  1. Click Choose image

  2. Click Upload files (or drag and drop!)

    The Select media dialog for images, with the Upload files button highlighted.
  3. Select a JPG, PNG, GIF, WebP or SVG file under 5MB. If your image is larger than 5MB, we recommend scaling it down with a free tool like Squoosh

  4. Optional: to rename it, click it on the Media page and change Name

  5. Find all your images in the Media library tab

Choose a royalty-free image

  1. Click Choose image

  2. Click the Royalty-free images tab

  3. Search for the image you want (powered by Unsplash's library of free images)

  4. Click an image to select it

  5. Click Add to experience

Image avatars

You can use images as avatars that appear alongside audio introductions and expert tips. Set your avatar in:

  • Experience settings - Applies to all audio across the experience (recommended for consistency)

  • Individual audio files - Override the experience-level setting for specific clips

In Settings, choose a position from the list under Audio avatar: Bottom-center aligned, Bottom-right aligned, Bottom-left aligned, Top-center aligned or Hidden. On an individual clip, select Override the experience's avatar, and then choose Show or Hide.

Set a position without choosing an image and a floating orb appears instead.

Add PDFs to your experience

You can upload PDFs to the Media Library and use individual PDF pages in your activities. This is handy when you want to reuse content from existing slide decks, reports, or handouts without re-exporting them as images.

How to add a PDF

  1. From an activity that accepts an image, click Choose image.

  2. Click Upload files (or drag and drop your PDF anywhere).

    The Select media dialog for images, with the Upload files button highlighted.
  3. Once it processes, select the PDF in the Media library tab and click Choose pages to add. The page picker opens so you can choose which page to use.

  4. In Slideshow, you can select multiple pages and each one will be added as a separate slide.

  5. Optional: to rename the file, click it on the Media page and change Name.

Note: Only .pdf files are accepted. Other document formats like DOCX and PPTX aren't supported.

Where you can use PDF pages

PDF pages can be selected from the Choose image picker in the Slideshow activity, in quiz question images, and in the image on Discussion, Note, Reflection and Survey activities. Other images, such as the experience's image and audio avatar in Settings, accept image files only. In the Slideshow activity you can pick multiple pages at once and add them as separate slides; elsewhere you pick one page at a time.

Picking pages

When you select a PDF, a page picker opens with a grid of thumbnails. You can:

  • Click any page to select it

  • Shift-click for a contiguous range (when multi-page selection is supported)

  • To change the thumbnail size, use View larger pages and View more pages per row — your zoom preference is remembered in this browser

The confirm button label changes to match what you're doing — for example, Use page 3 for a single selection or Add 5 pages for a multi-select in Slideshow. Page numbers in the UI match the document (page 1 is the first page).

How PDF pages appear in the editor

Once added, image and PDF slots show a hover label of the source file. Images show the filename, and PDF pages show Page N • filename so you can see at a glance which page is in use. Clicking View larger on any image or PDF slot opens a full-screen preview with the same label across the top.

Using PDFs as email attachments

You can attach a PDF from the Media Library to a follow-up email. When you choose a file in the email attachment picker, its size appears next to the filename (for example, PDF • 3.2 MB ). Email attachments are capped at 5MB regardless of the file's size in the Media Library — if you select a file over 5MB, a toast lets you know: "This file is 7.5MB. Email attachments must be 5MB or smaller."

Add audio to your experience

Audio is a key element in making Makeshapes experiences engaging. We recommend putting as much effort into your audio as you would into your video content.

Makeshapes audio features

  • Audio introduction - Plays automatically at the beginning of an activity. The activity timer starts when audio begins. Great for transitions!

  • Expert tips - Optional audio that learners can play if they need help with an activity or discussion

  • Background music - Quiet audio that plays during activities or in the waiting room during registration

How to add audio

When you see a Choose audio button, you have four options:

Upload audio

  1. Click Choose audio

  2. Click Add media, and then click Upload files (or drag and drop!)

    The Select media dialog for audio, with the Add media menu open, listing Upload files, Record audio and Text-to-speech.
  3. Select an MP3, WAV, OGG, AAC or M4A file under 20MB. If your file is larger, use Audacity to trim or compress it

  4. Optional: to rename it, click it on the Media page and change Name

  5. Find it later in the Media library tab

Record audio

  1. Click Choose audio

  2. Click Add media, and then click Record audio

    The Select media dialog for audio, with the Add media menu open, listing Upload files, Record audio and Text-to-speech.
  3. Click Start recording. If your browser asks to use your microphone, allow it

    The Record audio step before recording starts, with the Start recording button highlighted.
  4. To stop for a moment, click Pause

    The Record audio step while recording, showing Recording, the time so far and the Pause button highlighted.
  5. To listen back to your recording, click Play your recording

    A paused recording with the Play your recording button highlighted.
  6. To keep your recording, click Save

    A paused recording with the Save, Resume recording and Start over buttons. Save is highlighted.
  7. Wait a few seconds for processing

  8. Click Add to experience to use it

A recording pauses itself at 10 minutes. To add to the end of a paused recording, click Resume recording. To discard it and begin again, click Start over, and then confirm. Until you click Save, nothing is added to your Media library. If you leave first, Makeshapes asks whether to discard the recording.

Generate audio with text-to-speech

  1. Click Choose audio

  2. Click Add media, and then click Text-to-speech

    The Select media dialog for audio, with the Add media menu open, listing Upload files, Record audio and Text-to-speech.
  3. Write the script, choose a voice and generate the audio

Choose royalty-free audio

  1. Click Choose audio

  2. Click the Royalty-free audio tab

  3. Browse audio files specifically designed for background use

  4. File names say what they suit: waiting rooms, activities or reflection periods

  5. Click to select and add to your experience

Editing audio

To open an audio file's details, click it on the Media page (/media-library), or select it in the Media library tab and click Edit. In the details you can:

  • Trim - Drag the waveform handles, or enter precise Start and End times in seconds

  • Name - Give it a more descriptive name in your library

  • Avatar - Change the avatar image, visibility or position for this clip, after you select Override the experience's avatar

  • Used in 2 experiences - See which experiences use this audio

  • Visibility - See who can see the file, and change it if you're allowed. See Who can see a file

  • Delete audio file - In the More menu, remove it from your library (not possible while it's in use)

Audio avatars

Create a more personal feel (similar to Loom videos) by adding an avatar that appears during audio playback:

Set at experience level (recommended for consistency)

  1. In the experience, click Settings

    The Settings page, with Settings highlighted in the experience navigation and Audio avatar in the Media panel.
  2. Scroll to Audio avatar

  3. Choose an avatar image

  4. In the list under Audio avatar, choose a position, like Bottom-center aligned

  5. This applies to all audio in the experience

Set for individual audio

  1. Click the audio on the Media page

  2. In the Avatar card, select Override the experience's avatar

  3. Choose Show or Hide

  4. If you chose Show, choose a photo with Choose photo, and click a circle to set the position

  5. This overrides the experience-level setting for this specific audio

Floating orb style

  • Set the position without uploading an image

  • A dynamic, animated orb will appear during playback

Deleting media

Understanding media usage

Before you can delete a media file, you need to understand where it's being used. Every media item in your library tracks its usage across:

  • Experience content - Activities and sections using this media

  • Email attachments - Email sequences that include it

  • Email body - Images embedded in email content

  • Avatars - Audio clips using this image as an avatar

How to delete media

  1. Click Media in the sidebar or visit /media-library

    The sidebar of the creator app, with Media highlighted.
  2. Click the media item you want to delete

  3. In the file's details, click More, and then click the delete option: Delete audio file, Delete image, Delete video or Delete document

    The details of an audio file with the More menu open and Delete audio file highlighted.
  4. To confirm, click Delete

    The dialog asking to delete a media file, with the Delete button highlighted.

Delete multiple items at once

On the Media page ( /media-library ):

  1. To choose several items, click Select

    The Media page toolbar with the Select button highlighted, next to the grid and list view buttons.
  2. Click items to select or deselect them

  3. To remove the selected items, click Delete 3 items (the number matches your selection)

    The Media page with three items selected and the Delete 3 items button highlighted in the bar of selected items.
  4. To confirm, click Delete

    The dialog asking to delete three items, with the Delete button highlighted.

Items that are currently in use by an experience cannot be deleted.

Cannot delete media in use

If the media is currently being used, its delete option opens a dialog that shows exactly where it's in use. You cannot delete media that's actively used in your experiences.

The This audio file is in use dialog, listing the experience that uses it, with a Close button.

To delete media that's in use:

  1. Note where the media is being used (listed in the dialog, and on the Used in button in the file's details)

  2. Go to each experience listed

  3. Remove the media from all activities, sections, emails, or avatar settings

  4. Publish the experience to save your changes

  5. Return to the Media library

  6. Try deleting again - the delete option, such as Delete audio file, should now ask you to confirm

A file used by an experience in a project you're not in is also in use. The dialog says "Used by an experience in another project". Ask someone in that project to remove it first.

Important: You may need to publish experiences after removing media. Removing media from an unpublished draft won't always allow deletion - the published version still references it.

Delete an experience's files

When you delete an experience, the dialog can offer Also delete its files. It lists the files only that experience used, and none are selected. Select the ones to delete. Deleted files can't be brought back.

File size limits and formats

  • Images: 5MB maximum (JPG, PNG, GIF, WebP, SVG)

  • Documents/PDF: 20MB maximum (PDF only)

  • Email attachments: 5MB maximum (regardless of the file's size in the Media Library)

  • Audio: 20MB maximum (MP3, WAV, OGG, AAC, M4A)

  • Video: 2GB maximum (MP4, MOV, WebM, M4V)

  • Subtitles: 5MB maximum (VTT format only)

Tips for best results

  • Use descriptive names - Makes finding media easier later, especially in large libraries

  • Set avatars at experience level - Ensures visual consistency across all audio

  • Use short videos - Break long content into bite-sized pieces with engaging activities between

  • Add subtitles - Improves accessibility and helps non-native speakers

  • Use background music - Enhances engagement during interactive activities

  • Filter by usage - Find media used in specific experiences when building

Other languages, and audio you don't have

Did this answer your question?