Media library

The media library is where the images used on your site live. From here you can upload new images, find existing ones, tag them for later, and fill in the details that make each image useful wherever it's referenced on your site.

Non-image uploads — PDFs, brochures, and other documents — live alongside the media library in the Files area, which works in a similar way but with a smaller set of details to fill in.

Browse and find

Open Media under Media in Basker. The top right has two view toggles — All Media for a flat list of every item, and By Folder to browse items organised into folders. CREATE FOLDER at the top right lets you add a new folder and drag items into it. Search the library by file name from the search bar.

Upload new media

Click CREATE NEW to add an image. The upload panel offers three paths:

• Select a file from your computer.
• Paste URL — give Basker a URL to fetch and store the image.
• Drag and drop — drop a file directly onto the upload panel.

After uploading, take a moment to fill in the item's details — especially alt text. Items added during a content edit (for example, while writing a page) are saved into the library automatically, so you can reuse them later.

For uploading many files at once — typically PDFs, programmes, or other documents — see Files, where bulk upload lives.

Edit an item's details

Each media item has details you can edit at any time:

• Alt text — describes the image for screen readers and search engines. Add this to every image; it's the most important field for accessibility. Click Generate Alt Text after saving the image and Basker will suggest a description for you to review and refine — see AI features.
• Caption — a short description that may appear alongside the image, depending on how your theme uses it.
• Credit — the photographer, designer, or rights-holder of the image.
• Tags — labels you can apply to group related items together and find them faster later.
• Custom metadata — extra key-and-value information you want to keep alongside the file, such as a license reference or an internal code.
• Focal point — for images, the part of the picture that should always stay in frame when the image is cropped to different shapes by your theme.

Where this image is used

Each media item shows every place it's referenced across your site — pages, posts, events, reusable sections, and content blocks. Check this list before swapping or deleting an image so you know what changes when you do.

A practical example: before swapping a season hero image, check which event pages and posts still reference the old version. If anything still depends on it, update those references first — or replace the file behind the existing item, which updates every reference at once (see Reuse without re-uploading below).

Video

Video uploads through the same flow as images. Once a video is in the library, theme blocks can reference it the same way they reference images. Where exactly videos appear on the live site depends on your theme — most themes have a video block or an inline-video option in their content blocks.

For very large files, Basker monitors the upload and may prompt you to contact support if the file is unusually large or the format needs converting before it's usable. As a rule of thumb, encode video before uploading rather than relying on Basker to re-encode at scale.

Reuse without re-uploading

You don't need to upload the same file twice. Once an item is in the library, you can pick it from any page, event, or content block, and Basker will reference the same file. If you replace the file behind an item, every reference to it updates automatically.

Where to go next