Uploads
Uploads is the central media library for your careers site. Every image, video, font file, or document used in the CMS is stored here. You can upload files once and reference them from any page, block, or theme setting. To open Uploads, click CMS in the left-hand navigation, then select Uploads.Uploading files
Drag and drop files into the library, or click Upload to browse your computer. You can upload multiple files at once.
Once uploaded, you can click a file to add a description. This is useful for keeping the library organised, especially for images that look similar.
Supported file types
| Type | Formats | Max file size |
|---|---|---|
| Image | JPEG, PNG, GIF, WebP, SVG | 100 MB (also max 100 megapixels and 12,000 px per side) |
| Video | MP4, OGG, WebM | 100 MB |
| Font | WOFF, WOFF2, OTF, TTF | 100 MB |
| Lottie animation | .lottie | 10 MB |
| Document | PDF, Word, Excel, PowerPoint, CSV, plain text, Markdown, RTF, JSON, XML | 100 MB |
Uploaded videos can play on the page — add them through the Media block (and some card blocks), which plays the video file inline. The External video block is different: it embeds videos hosted on YouTube, Vimeo, or TikTok by URL, not files from your library.
Video handling
Studio processes uploaded videos to keep pages fast without you having to prepare them beforehand.- Automatic compression — short videos (up to 60 seconds) are compressed automatically, with almost no visible loss of quality.
- Trimming — you can trim a video to the length you need directly in the editor. The 60-second maximum is a limit set by Cloudflare and can’t be changed. If you upload a longer video and trim it under 60 seconds, the trimmed version is compressed too.
- Loading placeholder — while a video loads, Studio shows a placeholder still frame instead of a blank space, so pages don’t flash empty while media downloads.
Organising files into folders
Folders in Uploads are based on each file’s path rather than created up front.- To put a file in a folder, select it and click Move, then enter a path such as
/brand/people. - Any folders in the path are created automatically, and folders can be nested.
kebab-case folder paths. For page-specific assets, mirror the page slug where possible — for example, assets for /head-office can live under /pages/head-office/.
Finding files
Use the search bar at the top of the Uploads library to find files by name. A Live / Archived toggle switches between active and archived files.Renaming and archiving files
Click a file to open its detail panel, where you can rename it or update its description. To remove a file, use Archive — this takes it out of the active library while keeping it recoverable. Rename files before using them on pages. Use descriptive lowercase names such ashero-team-photo, icon-arrow-right, or dominos-logo-primary, rather than camera defaults like IMG_4521 or placeholders like final_FINAL_v2.
Using uploaded files in the CMS
Files from the Uploads library are available wherever you can add media in the CMS:- Media blocks — choose an image or video from the library
- Background images — set in section and column appearance settings
- Theme fonts — upload WOFF/WOFF2 files and reference them in Themes
- Theme favicon — set the browser tab icon in your theme
- Documents — link to PDFs or other files from buttons and rich text
Image sizing recommendations
| Use case | Recommended width |
|---|---|
| Hero or banner image | 1800–2400px |
| Content image (half-width column) | 1000–1200px |
| Card or thumbnail image | 600–800px |
| Logo (SVG preferred) | Any size, SVG |
FAQs
Can I play a video directly from the Uploads library?
Can I play a video directly from the Uploads library?
Yes. Upload your video and add it through a Media block — it plays inline on the page. You don’t need an external video host for basic playback.
My background video is slowing the page down.
My background video is slowing the page down.
Trim it as short as possible in the editor — for a looping background, a few seconds is usually enough. Short videos (up to 60 seconds) are compressed automatically, and Studio shows a placeholder frame while the video loads so the page never appears blank. See Video handling.
My image looks blurry on the page.
My image looks blurry on the page.
It’s probably smaller than the area it’s filling. Re-upload at a larger width — see the image sizing recommendations above — and replace it in the Media block.
How do I remove a file I no longer use?
How do I remove a file I no longer use?
Use Archive rather than permanent deletion. Switch between Live and Archived to manage files. Check the file isn’t referenced on a live page before archiving it.