Skip to main content

Free forever plan · 3,663 reachable storefronts · No credit card to start

Website & Branding

Use the Media Library for site assets

Upload, preview, search, and remove tenant-owned images and files while keeping public references safe.

Updated

On this page

Keep reusable site assets in one place

Open Dashboard > Website > Pages & Posts and choose the Media tab to manage tenant-owned images, documents, and downloads. Use meaningful file names and descriptive alt text so you can find the right asset later and customers using assistive technology can understand important images.

Plan availability: The Media Library is Pro in the active matrix. Free storefronts can still use the product and theme surfaces available to their plan. Knowledge Base article images use a separate system-admin upload flow and are not tenant Media Library records. Legacy Lifetime retains all platform features.

Upload and manage files

  1. Choose Upload Files and select the image, document, or download.
  2. Use descriptive file names to recognize assets in the library.
  3. Use Preview to confirm the file before placing it on a page or product.
  4. Check the storage-used indicator and remove files you no longer reference.
  5. Before selecting Delete, check whether the file is still used in your homepage, pages, products, or posts.

What customers see

The Media Library itself is an admin surface. Its Preview links use signed tokens that expire after 90 minutes; they are not permanent public URLs for custom CSS, buttons, or other long-lived page references. There is currently no permanent public URL for an ordinary Media Library upload. To use an illustration as a CSS background, host it at a stable public image URL outside the regular Media Library. The Website Editor can place images in supported homepage image areas, but it does not replace a built-in button with a custom illustration. A deleted file may break a supported placement that still uses it, so removal is a content change rather than simple housekeeping.

Common problems

  • Upload is unavailable. Check the active plan matrix and the Media Library feature gate.
  • The image is blurry or cropped badly. Upload a source that matches the intended placement and test the mobile layout.
  • The image has no useful alternative text. Describe the information the image adds, not only “image” or its file name.
  • A Knowledge Base image is missing from Media. KB images are uploaded through the KB editor’s system-admin flow and carry separate metadata.

Next steps


Keywords

Media Library, Upload Files, image upload, documents, Preview, Delete, alt text, storage used, broken image, Pro media

Was this article helpful?