Skip to main content

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

1
Open the Uploads library
2
Go to CMS → Uploads.
3
Upload your files
4
Drag and drop files into the library, or click Upload to browse your computer. You can upload multiple files at once.
5
Add a description (optional)
6
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.
7
For images, the description is also used as alt text. Write a complete sentence that describes the image for someone who cannot see it, and avoid starting with “image of” or “picture of”.
Upload all your brand images, logos, and fonts before you start building pages. Having them ready in the library makes page building much faster.

Supported file types

TypeFormatsMax file size
ImageJPEG, PNG, GIF, WebP, SVG100 MB (also max 100 megapixels and 12,000 px per side)
VideoMP4, OGG, WebM100 MB
FontWOFF, WOFF2, OTF, TTF100 MB
Lottie animation.lottie10 MB
DocumentPDF, Word, Excel, PowerPoint, CSV, plain text, Markdown, RTF, JSON, XML100 MB
Small SVGs (roughly 5 KB or less) are stored as icons so they can be coloured by your theme; larger SVGs are treated as ordinary images.
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.
Background and hero videos have the biggest impact on how quickly a page loads. Always trim them as short as possible — for a looping background, even a few seconds is usually enough — so the video compresses well and the page stays fast.

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.
Use lowercase 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 as hero-team-photo, icon-arrow-right, or dominos-logo-primary, rather than camera defaults like IMG_4521 or placeholders like final_FINAL_v2.
Archiving a file removes it from the active library. If the file is still used on a page or in your theme, archiving it will affect those places. Check it’s not in use first.

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 caseRecommended width
Hero or banner image1800–2400px
Content image (half-width column)1000–1200px
Card or thumbnail image600–800px
Logo (SVG preferred)Any size, SVG
Uploading images at the right size helps page load performance. If an image looks blurry on screen, it may be too small for the area it’s filling.

FAQs

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

Need help?