---
title: Media library
slug: configured-commerce/docs/media-library
createdAt: 2026-08-13T10:46:22.000Z
---

You can use the Admin Console's local file system to manage content. Use this article to learn some of the common tasks.

:::hint{type="info"}
**Note**

Additional options are often available by right-clicking an object. For example, right-click an image to view, download, rename, or delete the file.
:::

## File manager

Go to **Library > Media** to access the **Media Manager**.

![B2BMediaLibrary.png](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ijU57LUNS-80um_uNZkp9-20260720-144615.png)

## Folder panel

The **Folder Panel** displays content in a hierarchical tree view, making it easier to find and manage content.

:::hint{type="info"}
**Note**

Optimizely recommends that you limit the number of image files within a given directory to 1,000 to prevent performance issues while using the content manager.
:::

### Add folders

You can add a new folder by clicking **New Subfolder**. Folder names cannot start with a capital letter.

:::hint{type="info"}
**Note**

The **UserFiles** folder is the primary folder and cannot be the child of any other folder. You can add subfolders for a more complex folder hierarchy. The UserFiles folder name cannot be changed.
:::

## Toolbar

The toolbar is used to access the File Manager features.

![B2BMediaLibraryToolbar.png](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pikqPlEG0m4j0NgqLqJ-D-20260720-144615.png)

### Upload a file

1. Go to **Admin Console** > **Library** > **Media**.
2. Select the file destination from the **Folders Panel** or create a folder.
3. Click **Upload**.
4. Select the desired files and click **Open**.

### Accepted file types

The **Media Library** supports the following file extensions:

**General files –** .7z, .asf, .avi, .doc, .fla, .gz, .gzip, .mid, .mov, .mp3, .mp4, .mpeg, .mpg, .ods, .odt, .pdf, .ppt, .pxd, .ram, .rar, .rm, .rmi, .rmvb, .rtf, .sdc, .sitd, .sxc, .sxw, .tar, .tgz, .tif, .tiff, .txt, .vsd, .wav, .wmv, .xls, .xml, .zip

**Image files –** .bmp, .gif, .png, .jpeg, .jpg

**Flash files –** .swf, .flv

You can add additional file extensions using Additional Media Manager Extensions. Any extensions added should NOT be preceded with a period. Restart the site to update the Additional Media Manager Extensions.

## Files

The **Files** section displays all the files within a selected folder. By default, each file shows as a small thumbnail.

### Change how files display

Click **Settings** to access a variety of display options:

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/o_CnN2yxqkuFIDQhrTae--20260720-144615.png)

### Delete a file

1. Select the file and click **Delete.**
2. Click **OK** in the message that displays to delete the file. 

### Move a file to a different folder

You can click and drag a file to move it to another folder. The folder name is bold when you select it.

### Overwrite files in file manager

When a new file is added to the file manager with the same name as an existing file, this message appears: "A file with the same name is already available. The uploaded file was renamed to FILENAME(1).ext." You can modify your settings to have files of the same name automatically replace each other.

1. Go to **Admin Console > Administration > Settings.**
2. Search for "Overwrite Duplicate Media Manager Files" or go to **System Settings > General > Additional Media Manager Extensions.**
3. Change the setting to **YES**.
4. Click **Save**.

## Host site verification and other `.well-known` files

Site verification files (Apple Pay domain association, `security.txt`, OpenID configuration files, and similar files that must be served from a site's `/.well-known/` path) can be uploaded through the Media Manager and served directly from the storefront, without a deployment.

1. In the Media Manager, go to `_system` > `.well-known` (create the `.well-known` subfolder if it doesn't already exist).
2. Upload the file.

The file becomes available immediately at `https://yoursite.com/.well-known/<filename>`.

Some providers require a URL without a file extension. A single upload covers both forms, so if you upload `config.json`, both of the following return it:

- `https://yoursite.com/.well-known/config`
- `https://yoursite.com/.well-known/config.json`

:::hint{type="info"}
**Note**

The `_system` folder is restricted. Only users in the **ISC\_Implementer** or **ISC\_System** roles can add, rename, or delete files there.
:::

:::hint{type="danger"}
**Warning**

Files uploaded under `.well-known` are served anonymously to anyone who requests them. Don't put secrets in this folder.
:::