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 transcript
In this video you will learn where your pictures and videos live in PersonaCart. It is for anyone adding images to a page, product or blog. You will read your file counts, open the add sheet, and find, preview and copy a file link. This card counts everything you have added: forty-nine files here. These tabs split your files by kind: images, videos, documents and audio. Press Add photos or videos. It opens your computer's file picker. I upload nothing. Filter narrows the list to the kind of file you want. Newest first sets the order. New files appear at the top. New folder keeps your files tidy. List view shows each file in a row, with its name and size. Each file has Preview, Copy link and Download. Copy link lets you reuse it anywhere. Common mistake: a file over your plan's size limit will not upload. So: add files once, then find, preview and copy any link to use it anywhere. Thank you so much for watching PersonaCart. To read the full guide, go to docs dot personacart dot com. To try PersonaCart yourself, go to personacart dot com. And subscribe, so you do not miss the next tutorial.
Video transcript
In this video you will learn how to organise your photos and videos. You will read your counts, narrow the list, and see where folders live. Nothing is changed or deleted. This card counts everything in your library: forty-nine files, photos and videos together. These tabs split the library by kind: images, videos, documents and audio. Filter narrows the list to just the files you want. Newest first sets the order. New files appear at the top. Folders sit above your files. They group files so a big library stays tidy. New folder starts a new group. A file's link never changes when you file it. A small box asks for the folder name. I stop here and create nothing. So: read the counts, filter, sort, and group your files into folders. Thank you so much for watching PersonaCart. To read the full guide, go to docs dot personacart dot com. To try PersonaCart yourself, go to personacart dot com. And subscribe, so you do not miss the next tutorial.
Video transcript
In this video you will learn how to read a file's details in your media library. You will see its alt text, tags and link, and where Delete sits. Nothing is saved or removed. Click the top of a file's picture and a details sheet opens. Alt Text describes the picture for people who cannot see it. Auto-generate with AI writes a draft. Read it before you save. Tags are words that help you find the file later. Copy URL gives you the link to use the file anywhere. Delete is here. It always asks first, and I do not press it. So: open a file, describe it, check where it is used, and delete only after the warning. Thank you so much for watching PersonaCart. To read the full guide, go to docs dot personacart dot com. To try PersonaCart yourself, go to personacart dot com. And subscribe, so you do not miss the next tutorial.
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) 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.
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.
A secure file never appears on a public page. Use Public for anything on your storefront.
Deleting a file that a live page uses leaves a broken picture there. Check Used in first.
Questions
What's the difference between a public and a secure file?
Public files (like product photos) can be seen by anyone who visits your page. Secure files (like a paid course video) are locked behind buyer sign-in and only reach buyers who bought the course.
How do I know if a file is still in use before deleting it?
Open the file. Used in lists every place that uses it. If it says Not tracked, check your pages and products by hand.
Do folders change my picture links?
No. Moving a file into a folder, renaming a folder or deleting a folder never changes a file's link.
Where do I add alt text?
In Asset Details, under Alt Text. It helps screen readers and search engines. Auto-generate with AI can write it for you.
What happens when I run low on storage?
The Storage counter turns amber, then red past 90%, and a card suggests the plan with more space. You can also delete files you no longer use.
Every field on this screen
Every field on a media item. Read straight from the live app, so it matches what you see.
| Field | Type | What it accepts | What it does |
|---|---|---|---|
| After Label | Text | — | |
| Alt Text * | Text | — | |
| Before Label | Text | — | |
| Call to Action | Text | — | |
| Category | Dropdown | — | |
| Collection Name | Text | — | |
| Comparison Features | Text | — | |
| CTA Text | Text | — | |
| Customer Name | Text | — | |
| Customer Quote | Text | — | |
| Discount % | Slider | — | |
| Filename | Text | — | |
| Left Product | Text | — | |
| Original Price | Text | — | |
| Price | Text | — | |
| Product Name | Slider | — | |
| Product Title | Text | — | |
| Products | Text | — | |
| Rating | Text | — | |
| Review Text | Text | — | |
| Reviewer Name | Text | — | |
| Right Product | Text | — | |
| Sale Price | Text | — | |
| Sale Text | Slider | — | |
| Security Policy | Choice | — | |
| Sort | Dropdown | — | |
| Status | Dropdown | — | |
| Store Name | Text | — | |
| Subtitle | Text | — | |
| Tagline | Text | — | |
| Tags * | Tags | — | e.g. Add a tag... |
| Title | Dropdown | — | Choices: CrossfadeSlideZoom |
| Transition Style | Dropdown | — | Choices: CrossfadeSlideZoom |
| Type | Dropdown | — | |
| Variants | Text | — |
35 fields, read from the live app. Which ones you see depends on the product type and your plan.
What this screen looks like in every state
| State | When you'll see it | What you see, and what to do |
|---|---|---|
| Empty | Nothing matches the filters or search you have applied | “No files match your filters” — the data may well exist; clear the filters or widen the date range to see it. |
| Loading | The screen is fetching your data | A skeleton in the shape of the finished page. It should be brief — if it persists, the load has failed rather than stalled. |
| Error | The data couldn't be loaded | A message with a retry. Retry first: most of these are a dropped request, not a broken store. If it repeats, the outage is upstream and reloading won't help. |
| No access | Your role doesn't include this screen | A permission notice instead of the page. An owner or admin can grant access under Settings → Team. |
When something goes wrong
These are the messages this screen can show you, and what each one means.
| If you see | What to do |
|---|---|
| File URL not available | The file was rejected. Check its size and type against what the field accepts. |
| No preview URL available | Retry the action. If it keeps happening, contact support with what you were doing. |
| No preview available | Retry the action. If it keeps happening, contact support with what you were doing. |
| Secure assets cannot be downloaded | Retry the action. If it keeps happening, contact support with what you were doing. |
| Secure assets don't have public URLs | Retry the action. If it keeps happening, contact support with what you were doing. |
| Secure assets require authenticated access | Retry the action. If it keeps happening, contact support with what you were doing. |
| Upload blocked for your safety | Do what the message asks, then try again — it names exactly what's missing. |
| Upload failed | Do what the message asks, then try again — it names exactly what's missing. |
Related
Part of Online Store and Storefront Guide · Product page: PersonaCart features