Media Library: Managing Images and Files

Every image you add to a blog post, every product photo you upload, and every PDF document you attach to a page is centrally stored in the PolyCMS Media Library.

This centralized approach means you can upload an image once, and reuse it across multiple different posts and products without duplicating the file on your server.

Accessing the Library

Navigate to Media in the main admin sidebar.

Here you will see a grid (or list) of all your uploaded files. You can use the search bar at the top to find specific files by name, or use the filter dropdowns to show only Images, Videos, or Documents.

Uploading New Files

There are two ways to upload files:

Directly to the Library: Click the Add New button on the Media screen. You can then drag and drop multiple files from your computer directly into the browser window.

While Writing Content: When you are inside the Post Editor or Product Editor and you click to add an Image Block or a Featured Image, the Media Library modal will pop up, allowing you to upload files right then and there.

Image Optimization and SEO

Search engines cannot "see" images; they read the code behind them. Therefore, properly labeling your images is crucial for Image SEO and Accessibility.

Click on any image in the Media Library to open its details panel. You should always fill out:

Alt Text (Alternative Text): Describe what the image shows. This is used by screen readers for visually impaired users, and by Google to understand the image context. (e.g., "A person typing on a laptop with the PolyCMS dashboard open").

Title: The internal name of the file (e.g., "Dashboard Screenshot").

Caption: Optional text that appears visibly underneath the image when embedded in an article.

Deleting Files

To keep your server storage clean, you should delete files you no longer need.

Click on a file to open its details, and click the red Delete Permanently link.

Deleting a file from the Media Library will immediately break the image link on any Post, Page, or Product where it was currently being used. Ensure you are not actively using an image before deleting it!