# Media Library: Upload and Organise Files

> How to use the PersonaCart Media Library: upload photos, video, audio and PDFs, use folders and search, set public or secure access and add alt text.

Source: https://docs.personacart.com/storefront/media-library

In short: {"How to use the PersonaCart Media Library: upload photos, video, audio and PDFs, use folders and search, set public or secure access and add alt text."}

- The Media Library is the shared shelf for every file your store uses: product photos, course videos, audio, PDFs, your logo.
- Add a file once, use it anywhere, and see where it is used before you delete it.
- The screen's own title is **Photos and videos**: "The pictures and videos you use on your page, products and blog. Add them here once, use them anywhere."

Video: Add photos and videos to your media library and find them again (https://www.youtube.com/watch?v=42zvd0bKDoY)

Video: Organise your photos and videos in the media library (https://www.youtube.com/watch?v=-Xeva26b9dM)

Video: Media file details: alt text, tags, link and delete with care (https://www.youtube.com/watch?v=TbEqzXtBFM0)

1. Open **Storefront → Media Library** and press **Add photos or videos**.
2. Choose **Who can see these?**.
3. Press the **Add** button at the bottom of the sheet (it reads **Add 1 file**, **Add 3 files** and so on) and keep the sheet open until uploads finish.

## Where to find it

Sidebar → STOREFRONT → Media Library. On a phone, **Media** can be pinned to the bottom bar. Pickers elsewhere (the editor's **Choose picture**, the product editor, the blog's **Featured Image**) open the same library.

## What you see

**Header:** the title **Photos and videos**, **Make a video** (see [Create Video](/storefront/create-video)) and **Add photos or videos**.

- **Counters:** **Total files**, **Images**, **Videos** and **Storage used** (the size and, on a plan with a storage limit, the percentage; it turns amber past 70% and red past 90%).
- Tabs under the counters split the files by kind: images, videos, documents and audio.
- The card below reads "N files in your media library" with an **Upload** shortcut.
- When storage runs low, **Running low on storage** suggests the plan that gives more, with **Upgrade Plan**.

**Toolbar:**

| Control | What it does |
|---|---|
| **Search files...** | Finds files by name. |
| **Filter** | **Type** (**All Types**, **Image**, **Video**, **Document**, **Audio**), **Category** (**All**, **Public**, **Secure**), **Status** (**All**, **Ready**, **Processing**, **Error**) and, once you have folders, **Folder** (**All folders**, **Uncategorized**, or one of your folders with its file count). |
| **Sort** | **Newest first**, **Oldest first**, **Name (A-Z)**, **Size (largest)**. |
| **New folder** | Makes a folder: "Group media into folders. A file's link never changes when you file it." |
| **Grid view** / **List view** | Thumbnails, or a table with **Name**, **Type**, **Category**, **Size**, **Dimensions**, **Usage**, **Uploaded** and **Status**. |

- Below the grid, "Showing N of M files" and **Load more**.
- A tip reminds you that you can drag and drop files anywhere on the page.
- While viewing one of your own folders, **Rename folder** and **Delete folder** appear ("The files inside it are not deleted: they move back to your library and every link to them keeps working.").

Each thumbnail shows **Ready**, **Processing** or **Error**, and **Public** or **Secure**. A file whose use cannot be tracked shows **Not tracked**.

With no files yet the page shows **Add your first photo** with three steps (tap **Add photos or videos**, wait until it is in, then use it with **Choose picture** while editing a page or product) and a greyed **Example** that is never saved.

## Upload and manage files

### Add files

  Press Add photos or videos, or drag files onto the page. Supported: JPEG, PNG, GIF, WebP, MP4, MOV, WebM, MP3, WAV and PDF, each up to your plan's file size ("Each file can be up to N MB").
  In the sheet, see "N files chosen" and answer Who can see these?: Anyone who visits my page (recommended) for your page, products and blog, or Only students who bought a course for lessons ("Not shown on your page").
  Press the Add button (it reads Add 1 file, Add 3 files and so on). A progress bar shows each upload; keep the sheet open until all are done. A video is processed after upload (Transcoding video...).

After your very first upload a message says "Your first photo is in" with **Next: use it on your page**, which opens [Pages](/storefront/pages).

### Look at and edit one file

Click a file to open **Asset Details**:

| Field | Meaning |
|---|---|
| Preview | **Open Full Size**, **Preview Video**, **Open Audio File** or **View Document**. |
| **Filename**, **Type**, **MIME**, **Dimensions**, **Duration**, **Uploaded by**, **Uploaded** | Facts about the file. |
| **Alt Text** | "Describe this image for accessibility...". **Auto-generate with AI** writes it for you. |
| **Tags** | Add words to find the file later. **Auto-Tag with AI** suggests tags. |
| **Security Policy** | **Public** ("Accessible via CDN URL. For product pages, landing pages, marketing.") or **Secure** ("Requires buyer authentication. For course lessons and paid content only."). |
| **Used in (N places)** | Every page, product or block that uses the file, or **Not used anywhere**. |

- Buttons: **Copy URL**, **Download**, **Replace** (choose another file to swap in), **Delete** and **Save Changes**.
- Changing **Public** to **Secure** asks first: "Secure assets require buyer authentication. They can only be used in courses and lessons. The public URL will be removed." Secure files cannot be copied or downloaded here.

### Work on several files

Tick files. The bar shows how many are **selected** with **Add Tags** (adds to every selected file; existing tags stay), **Move to folder** (pick a folder or **Library root**), delete, and **Clear selection**.

### Folders

**New folder** asks for a name (for example "Product photos"). Moving a file into a folder never changes its link. **Rename folder** changes only the name. **Delete folder** keeps the files.

### Delete a file

Deleting asks first. If the file is used, the box lists where: "Deleting it will create broken references." If it is not used: "This action cannot be undone." If usage cannot be checked: "it may be used elsewhere. Check before deleting." Deleting several files shows how many are in use.

## Good to know

- **Storage counts against your plan.** The Storage card breaks use down by type (**Images**, **Videos**, **Documents**, **Audio**) and by **Public** / **Secure**.
- **AI alt text and AI tags** use AI credits and need a plan that includes them.

:::note[Secure files never show on public pages]
**A secure file never appears on a public page.** Use Public for anything on your storefront.
:::

:::warning[Deleting a file in use breaks pictures]
Deleting a file that a live page uses leaves a broken picture there. Check **Used in** first.
:::

## Questions

## Every field on this screen

Every field on a media item. Read straight from the live app, so it matches what you see.

## What this screen looks like in every state

## When something goes wrong

These are the messages this screen can show you, and what each one means.
