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:
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
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.
See who can see a file
Click Media in the sidebar, and then click the file.
In the file's details, read the Visibility section.
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.
In the Visibility section, click Change access.
Under Who can see this file, choose All access or Only these projects.
If you chose Only these projects, select the projects under Projects.
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.
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
Add a Video activity to your desired section
Click Choose video
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
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
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
Click Choose image
Click Upload files (or drag and drop!)
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
Optional: to rename it, click it on the Media page and change Name
Find all your images in the Media library tab
Choose a royalty-free image
Click Choose image
Click the Royalty-free images tab
Search for the image you want (powered by Unsplash's library of free images)
Click an image to select it
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
From an activity that accepts an image, click Choose image.
Click Upload files (or drag and drop your PDF anywhere).
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.
In Slideshow, you can select multiple pages and each one will be added as a separate slide.
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
Click Choose audio
Click Add media, and then click Upload files (or drag and drop!)
Select an MP3, WAV, OGG, AAC or M4A file under 20MB. If your file is larger, use Audacity to trim or compress it
Optional: to rename it, click it on the Media page and change Name
Find it later in the Media library tab
Record audio
Click Choose audio
Click Add media, and then click Record audio
Click Start recording. If your browser asks to use your microphone, allow it
To stop for a moment, click Pause
To listen back to your recording, click Play your recording
To keep your recording, click Save
Wait a few seconds for processing
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
Click Choose audio
Click Add media, and then click Text-to-speech
Write the script, choose a voice and generate the audio
See Generating audio with text-to-speech for the details.
Choose royalty-free audio
Click Choose audio
Click the Royalty-free audio tab
Browse audio files specifically designed for background use
File names say what they suit: waiting rooms, activities or reflection periods
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)
In the experience, click Settings
Scroll to Audio avatar
Choose an avatar image
In the list under Audio avatar, choose a position, like Bottom-center aligned
This applies to all audio in the experience
Set for individual audio
Click the audio on the Media page
In the Avatar card, select Override the experience's avatar
Choose Show or Hide
If you chose Show, choose a photo with Choose photo, and click a circle to set the position
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
Click Media in the sidebar or visit /media-library
Click the media item you want to delete
In the file's details, click More, and then click the delete option: Delete audio file, Delete image, Delete video or Delete document
To confirm, click Delete
Delete multiple items at once
On the Media page ( /media-library ):
To choose several items, click Select
Click items to select or deselect them
To remove the selected items, click Delete 3 items (the number matches your selection)
To confirm, click Delete
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.
To delete media that's in use:
Note where the media is being used (listed in the dialog, and on the Used in button in the file's details)
Go to each experience listed
Remove the media from all activities, sections, emails, or avatar settings
Publish the experience to save your changes
Return to the Media library
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
If your organization translates its experiences, an asset can carry a different file per language. See Using media in other languages.
Need narration and don't have a recording? Makeshapes can generate it from text. See Generating audio with text-to-speech.

























