Choose and upload media

Choose a file where you use it

Your media library holds the pictures, sounds and videos you use in overlays, alerts, flows, giveaways and other parts of your channel. You keep it tidy on the Media page in the sidebar. To use a file, start at the field where it will go; you do not need to leave the task to add one.

1. Open the part you are editing, such as an Image layer in Overlays or Cover art on a giveaway's Prize step.
2. Press Choose picture, Choose sound, Choose video or Choose media, depending on the field. Your library opens with folders on the left, Search your library above the files and Preview beside them. Filters shows tags and, when several types are offered, a type filter. Recent uploads changes the order.
3. Check the destination named in the picker, select a file to inspect it, then press Use picture, Use sound, Use video or Use media. For a Slideshow or Marketplace previews, use Add pictures, select several, then press Use 3 files (the button shows your actual count). The selected strip keeps their order and the footer says how many more fit. An incompatible file can be inspected, but the preview explains why it cannot be used.
4. Wait for the choice to apply, then save or publish the thing you are editing as you normally would. The new file choice follows that page's usual save or publish step.

Choose Recent choices to find files you successfully used earlier in this browser, for your account on this channel. It shows choices the current field supports. Your library has the full library, folders and search; Upload files adds a file without leaving the chooser. KLIPY has its own Recent list inside the KLIPY tab.

For a video or sound, use Play preview, Unmute preview, Seek preview and Preview volume to audition it. Preview volume changes only what you hear in the chooser. Stop preview returns to the start; returning to results or switching sources stops that audition. On a phone, select a file for the larger preview, then press Results to return to Your library, or Recent choices to return to that list.

When your device asks for reduced motion, uploaded GIFs show a still picture or a static file icon in the chooser. If a thumbnail cannot load, you can still use an available file. If the file itself is unavailable, it cannot be used; choose another file.

The destination stays named while you choose. After Use, the choice applies to that item and focus returns to its field. If the save fails, the chooser keeps your candidate and explains the problem so you can retry. An uploaded file stays in your library if you cancel before using it.

When an alert field says From theme, it is following the named theme’s media. Choosing a file makes an explicit choice for the named design. Where offered, Reset picture to theme or Reset sound to theme removes that choice and follows the theme again. The field also names the channel or theme design being edited; shared-design edits affect its other placements. See Choose alert media and sound.

For example, add an Image layer, press Choose picture, preview starting-soon.png, press Use picture, then publish the overlay. The picture appears in that layer in OBS. Choosing a file in a flow changes the flow's draft until you save it; it does not send anything to Twitch by itself.

Get help with your setup

Optional Help me uses the real saved media you choose. An uploaded file is prepared media, not proof of playback or visibility. Review its destination, licence and volume before using it in a flow or published overlay; help does not play it.

Find a GIF, sticker or clip

You can also find media without uploading a file. For example, choose a celebration clip for an alert or a reaction sticker for an Image layer.

1. Open the picture or video field and press Choose picture or Choose video.
2. Choose the KLIPY tab, then GIFs, Stickers or Clips. Start with Trending, use Recent to find something you have used, or type in Search KLIPY.
3. Select a result to see its larger Preview. Clip previews start muted. Press Unmute preview to hear it, then Mute preview to silence it again. Preview play, seek, mute and volume controls only audition the file; they do not change your alert or destination’s stored sound settings.
4. Press Use GIF, Use sticker or Use clip. When the field accepts several files, press Add GIF, Add sticker or Add clip for each choice, then Use 3 files with your actual count. Your selections stay in order when you switch sources.
5. Save or publish the thing you are editing as usual. An Image or Slideshow plays a clip silently; an alert follows its existing sound and volume settings.

A destination that requires a still picture offers Use poster instead. This uses the still image KLIPY supplies; it does not turn a clip into a picture without telling you. If no compatible poster is available, choose another result.

Marketplace covers and previews use uploads, because a listing keeps its own copy.

KLIPY keeps hosting the media. A selection does not use your uploaded-file storage, and it cannot be copied into a downloadable media bundle. If KLIPY removes an item, choose a replacement. Report clip, Report GIF or Report sticker sends a report to KLIPY.

If KLIPY is unavailable or a search fails, your existing file stays selected. Retry the search, or switch to Your library to choose an upload.

Upload a new file

1. Press Upload beside an empty field, or Change beside its current file and then Upload files at the top of the picker. Choose files from your computer. The upload view also accepts a file dropped onto its drop area, and lists the accepted formats and destination folder. Save to names the target folder. To upload somewhere else, press Change folder, open that folder in Your library, then upload your next file. Files already in the queue keep their original destination.
2. Wait for each file to say Ready. A failed file keeps its message and a Retry action. Removing a row from the queue does not delete an uploaded file.
3. Inspect the preview and press Use picture, Use sound or the counted Use files action to apply it. Cancel keeps the previous destination choice; completed uploads remain in Your library.

On a phone, selecting a result opens its full preview. Results returns to Your library, or Recent choices returns to that list, with your search and selection preserved. The Use action stays at the bottom.

You can also upload several files from Studio’s Media tab or with Upload files on the Media page. These management views save files to the library without a destination Use step. Their upload list names each ready or failed file, with Retry for a failure.

Where the file lands is in Organise with folders and tags. Images and sounds can be up to 5 MB each; WebM video can be up to 25 MB. For custom graphics you can also upload 3D models as .glb files, up to 8 MB, and fonts as .woff2, .woff, .ttf or .otf files, up to 5 MB; filter by 3D models or Fonts to find them. The Media storage line in What your plan includes shows the space your channel has. The same limits hold when a file travels in a shared listing or a .bloop.zip bundle file, which holds up to 95 MB in all (List your flows and themes in the marketplace).

If an upload is refused, the previous choice stays in place and the message explains what to change. A file can be refused for its type, size or remaining storage space. For Marketplace covers and previews, a picture also has to be 16:9, such as 1920×1080; the picker shows its dimensions before you choose it.

Organise with folders and tags

Once you have more than a handful of files, sort them. Open Media in the sidebar, under On stream. The Folders list on the left has All media at the top, Not in a folder for files you have not filed, then your folders. A file lives in one folder at a time. Tags are the other way to find things: a file can carry several, and a tag works across every folder.

1. Press New folder, type a name (up to 48 characters) and press Create folder. With a folder open, the new one goes inside it. Folders nest up to three levels, such as Alerts, Subs.
2. Open a folder to work on it. Folder actions offers Rename…, Move to…, Share to marketplace (Share a media pack) and Delete…; the trail above the files (All media › Alerts › Subs) takes you back up.
3. To file a picture or sound, drag its tile onto a folder in the list, or use its three-dot icon (More) and choose Move to…. Select several files first and drag any one of them to move the lot. Not in a folder in the list is a place you can drop files too.
4. To tag a file, select its three-dot icon (More) and choose Edit tags…. Type a tag and press Enter, remove one with the cross beside it (Remove tag), then Save tags. A tag is up to 32 characters and a file carries up to 20.
5. Press a tag chip above the files to see only files with that tag, from every folder. Press it again to clear it. With a tag chosen, Rename tag… appears: it renames the tag on every file at once, and if another tag already has that name the two merge.
6. Type in Search all folders to look by file name across every folder. Each result names the folder it is in, or says Not in a folder, so you can tell two files with the same name apart. Clear filters brings the folder back. Use the type and sort selects to narrow by Images, Sounds or Videos and to order by Newest first, Name or Largest first.
7. To rename a file, select its three-dot icon (More) and choose Rename….
8. A big library opens 120 files at a time, so the page stays quick however many you have. Scrolling towards the end brings in the next batch by itself; Show more files, under the list, does the same for a keyboard or a short list and says how many are on screen, such as Showing 120 of 480 files. Search, tags and the type filter always look through every file, not only the ones already on screen.

Pictures and videos are drawn from a small copy that loads quickly, and a video shows a still frame until you press play. A file you have just uploaded shows the full picture until its small copy is ready, which takes a few minutes; nothing changes about the file itself.

Moving, tagging and renaming a file never breaks what uses it: an overlay, alert, theme or flow that points at the file keeps working, because it points at the file and not at its folder or its name.

For example, to keep your sub alerts together, make a folder Alerts with Subs inside it, drag sub-alert-cute.png and sub-chime.wav onto Subs, and tag both cute. Next month, pressing the cute chip lists everything cute from every folder at once.

Work on several files at once

Tick the box on a tile, or Select all files to take every file in the view (when your library is bigger than what is on screen, it first loads the rest, so the count is the whole view), and a bar appears above the files with the count. The bar stays at the top of the list as you scroll, and the answer to what you do (for example Moved 3 files to Alerts.) appears right under it. Move to… files them in a folder you choose, Add tag adds one or more tags to all of them, Remove tag lists the tags the selection carries and removes the ones you tick, Share to marketplace starts a media pack from them, and Delete… removes them. Clear selection starts over. Shift-click a second tile to take everything between two.

A file something still uses is never deleted this way: the message names what uses it, so you can change that first, and the other files in the selection still go. If a file would go over 20 tags, the message says which file, and the rest still get the tag.

Delete a folder

Choose Folder actions then Delete…. Deleting a folder deletes its subfolders and every file in them, so it first counts what would go. If any of those files is still used, the box lists each one and what uses it, and warns that whatever uses it will show nothing afterwards: an overlay layer draws no picture, a flow plays no sound. If one of your marketplace listings has any of those files, the box says so: the listing keeps its own copy, so the delete doesn't change it. You confirm by typing the folder's name; Delete folder stays greyed out until it matches. A folder with nothing in use only needs the button.

There is no undo. To keep a file the folder holds, move it out first, or use Move to… on the folder itself to file the whole folder somewhere else.

Uploads and duplicates

Upload files on the Media page puts the new file in the folder you have open, or at the top level when you are looking at All media or Not in a folder. If the file is already in your library, Bloopbot does not keep a second copy: it says Already in your library at the folder it is in, with Show to jump there. The existing copy stays where it was. The same goes when you upload from a picker or field.

In Studio and in every picker

You do not have to leave what you are doing. Studio's Media tab and every media picker show the same trail, subfolders, tag chips and search, and list files with their folder when the search or a tag spans every folder. In the picker, open Filters to choose a tag.

• Uploading from the open picker or from the Media tab puts the file in the folder on screen. Pressing a field's own Upload button, with no picker open, puts it at the top level.
• The Media tab can also rename a file, edit its tags and move it, from a file's three-dot icon (More). Creating, renaming and deleting folders, and renaming tags, are done on the Media page.
• The library and pickers remember compatible browsing choices for your channel and account on this device. A sound field keeps its own supported file types; it does not inherit an incompatible picture choice.
• A picker only shows the files that suit its field, such as pictures for a frame, so a folder can look emptier there than on the library page.

For an alert, start at Picture / GIF / Video or Sound in its workspace. The picker names the selected layer, shared design and destination field. Your choice applies to that destination even if you browse other layers; wait for the draft to save before publishing. Choosing or uploading a file does not play the published overlay. Use Test in editor to hear the draft and open More alert options · Shared design below the tests for Alert volume, which changes its stored level.

Files you add from the marketplace land in a folder named after the listing, inside a folder called Marketplace (The Marketplace). Rename or move them like any others.

Pictures for frames

A frame is a picture drawn as a border round a panel, a chat line or an alert card (Put a frame around panels, chat lines and cards). Its picker lists images only, and these suit it best:

• A PNG or WebP with a see-through middle. The panel’s own colour and background then show inside the frame. These formats keep the see-through parts and soft edges.
• Corners at least as big as the frame is thick. A picture is cut into nine pieces, and the four corners are drawn as they are. A 96 × 96 picture with 32-pixel corners works well: type 32 as the Corner size.
• A GIF works too. A JPEG works for a solid frame, but it cannot be see-through, so its corners are solid squares.
• Not accepted: SVG pictures, videos and sounds. Save vector art as a PNG first.

Upload it from the frame’s own control with Upload, or add it to the Media tab first and pick it with Choose picture. A file a theme or an overlay uses as a frame cannot be deleted from your library until you change that use, like a background image.

Replace or remove a file

Press Change to replace a chosen file. For an empty field, use its Choose action or Upload. Press the bin icon (Remove) beside them to clear it where the field allows an empty choice. If a file was deleted from the library, the field says Missing file instead of silently clearing the saved choice; pick another file or remove it. A slideshow keeps a missing picture in its ordered list so you can see which entry it skips on stream.

If the media library cannot load, press Try again where it appears, or refresh the page and reopen the picker. If a file cannot be deleted, it may still be used by a published overlay or another record; change that use first. Arrange your overlay explains the slideshow's ordering and missing-picture behavior.