Skip to main content

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."
Watch it: Add photos and videos to your media library and find them again
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.

Watch it: Organise your photos and videos in the media library
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.

Watch it: Media file details: alt text, tags, link and delete with care
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.

The Media Library screen in PersonaCart
Media 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:

ControlWhat it does
Search files...Finds files by name.
FilterType (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).
SortNewest first, Oldest first, Name (A-Z), Size (largest).
New folderMakes a folder: "Group media into folders. A file's link never changes when you file it."
Grid view / List viewThumbnails, 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​

  1. 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").
  2. 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").
  3. 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:

FieldMeaning
PreviewOpen Full Size, Preview Video, Open Audio File or View Document.
Filename, Type, MIME, Dimensions, Duration, Uploaded by, UploadedFacts about the file.
Alt Text"Describe this image for accessibility...". Auto-generate with AI writes it for you.
TagsAdd words to find the file later. Auto-Tag with AI suggests tags.
Security PolicyPublic ("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.
Secure files never show on public pages

A secure file never appears on a public page. Use Public for anything on your storefront.

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​

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.

FieldTypeWhat it acceptsWhat it does
After LabelText—
Alt Text *Text—
Before LabelText—
Call to ActionText—
CategoryDropdown—
Collection NameText—
Comparison FeaturesText—
CTA TextText—
Customer NameText—
Customer QuoteText—
Discount %Slider—
FilenameText—
Left ProductText—
Original PriceText—
PriceText—
Product NameSlider—
Product TitleText—
ProductsText—
RatingText—
Review TextText—
Reviewer NameText—
Right ProductText—
Sale PriceText—
Sale TextSlider—
Security PolicyChoice—
SortDropdown—
StatusDropdown—
Store NameText—
SubtitleText—
TaglineText—
Tags *Tags—
e.g. Add a tag...
TitleDropdown—
Choices: CrossfadeSlideZoom
Transition StyleDropdown—
Choices: CrossfadeSlideZoom
TypeDropdown—
VariantsText—

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​

StateWhen you'll see itWhat you see, and what to do
EmptyNothing 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.
LoadingThe screen is fetching your dataA skeleton in the shape of the finished page. It should be brief — if it persists, the load has failed rather than stalled.
ErrorThe data couldn't be loadedA 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 accessYour role doesn't include this screenA 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 seeWhat to do
File URL not availableThe file was rejected. Check its size and type against what the field accepts.
No preview URL availableRetry the action. If it keeps happening, contact support with what you were doing.
No preview availableRetry the action. If it keeps happening, contact support with what you were doing.
Secure assets cannot be downloadedRetry the action. If it keeps happening, contact support with what you were doing.
Secure assets don't have public URLsRetry the action. If it keeps happening, contact support with what you were doing.
Secure assets require authenticated accessRetry the action. If it keeps happening, contact support with what you were doing.
Upload blocked for your safetyDo what the message asks, then try again — it names exactly what's missing.
Upload failedDo what the message asks, then try again — it names exactly what's missing.