Appearance

Managing Media ​

Media refers to the images and files stored in your Foundry account. This guide explains how to upload, organise, and use images across your website.

What Is the Media Library? ​

The media library is a central place where all your images and files are stored. When you add an image to a page, you choose it from this library.

Think of it like a shared photo album for your website.

To open the media library, click Media Library in the left menu.

Uploading Images ​

You can upload images in two ways.

Option 1: Upload directly from the Media Library

  1. Click Media Library in the left menu.
  2. Click the Upload files button.
  3. Select one or more image files from your computer, or drag and drop them into the upload area.
  4. The images are saved to your library immediately.

Option 2: Upload through an image field on a page or blog post

  1. Open the page or blog post where you want to add the image.
  2. Find the relevant image field (for example, Featured Image or Background Image).
  3. Click the upload area or drag and drop your image file onto it.
  4. The image uploads immediately and is saved to your media library automatically.

Once uploaded, the image will appear in the Media Library.

You can upload images in the following formats:

  • JPG or JPEG (best for photographs)
  • PNG (best for logos or images with transparent backgrounds)
  • WebP (a modern format that loads quickly)

The Media Library can also store documents (such as PDFs) and videos, which you can filter for using the type filter above the library grid.

Finding Files in Your Library ​

As your library grows, use the tools above the grid to find what you need:

  • Search - type part of a file name to filter the list.
  • Type filter - narrow the view to Images, Documents, or Videos.
  • Site filter - if you manage more than one website, choose which site's files to view.

Adding Alt Text to Images ​

Alt text is a short written description of an image. It is read aloud by screen readers for visitors with visual impairments, and it also helps search engines understand what an image shows.

To add or update alt text:

  1. Open Media Library in the left menu.
  2. Click an image to open the preview panel.
  3. Type a short, plain description into the Alt text field (for example, "Team of five people smiling outside the office").
  4. Click Save.

Tip: Good alt text describes what is in the image, not how it is used on the page. Avoid phrases like "image of" or "picture of" - just describe what's there.

Replacing an Image on a Page ​

If you want to swap out an image that is already being used on your website:

  1. Go to the page where the image appears.
  2. Click the image upload area and select a new file from your computer, or drag and drop a new image onto it.
  3. Save the page.

The old image is not deleted from your library automatically. It stays in the media library until you remove it manually.

Deleting Images ​

To remove an image from your library:

  1. Open Media Library in the left menu.
  2. Find the image you want to delete.
  3. Click on the image to open the preview panel.
  4. Click the Delete file button.

Warning: Only delete images if you are sure they are not being used on your website. Deleting an image that is still in use will cause a blank space or broken image on the relevant page.

If you are unsure, leave the image in the library. Storage space is not a concern for occasional uploads.

Best Practices for Images ​

Following these tips will help your website look its best and load quickly for visitors.

File size

  • Aim for images under 500KB where possible.
  • Large image files slow down your website for visitors.
  • You can compress images for free at squoosh.app or tinypng.com before uploading.

Dimensions

  • Hero banner images work best at 1920 x 1080 pixels or similar wide proportions.
  • Profile photos or team images work best at a square ratio, such as 800 x 800 pixels.
  • If an image looks stretched or cropped oddly, it may be the wrong dimensions for that position.

File names

  • Name your files with clear descriptions, such as team-photo-2025.jpg rather than IMG_4873.jpg.
  • This makes it easier to find images later in your library.

Organising Your Media Library ​

As your library grows, it can become harder to find specific images. A few habits will keep it tidy:

  • Delete images you no longer need (as long as they are not in use).
  • Use clear, descriptive file names when uploading.
  • If you notice duplicates, keep the best version and remove the others.

Storage Usage ​

Your account has a storage allowance for uploaded files. When you have a site selected in the Media Library's site filter, you will see a usage bar showing how much of your allowance is used. If you are approaching your limit, remove images you no longer need or contact your support team about increasing your allowance.

Foundry by Brass Labs