Media Library
How to upload, organize, and use images and files throughout your CMS Max website
Overview
The Media Library is where all the files on your website live — images, PDFs, documents, and other uploads. When you add an image to a page or attach a file to content, it comes from here. Keeping your media library organized makes it faster to find what you need when editing content.

Uploading Files
From the Media Library
- Navigate to Template > Media Manager in the sidebar.
- Click Upload (or drag and drop files onto the page).
- Select one or more files from your computer.
- The files upload automatically and appear in the library.

While Editing Content
You can also upload files directly while editing a page or other content:
- In the content editor, click the image or file insert button in the toolbar.
- Choose Upload to add a new file, or browse existing files in the library.
- Select or upload the file, then insert it into your content.
Tip: Uploading files while editing content saves them to the same shared Media Library, so they are available everywhere on your site.
Supported File Types
The Media Library accepts common image, document, and media file types, including:
- Images: JPG, PNG, GIF, WebP, SVG, AVIF
- Documents: PDF, Word (DOC/DOCX), Excel (XLS/XLSX), PowerPoint (PPT/PPTX)
- Audio/Video: MP3, MP4, MOV, WebM, and others
Managing Files
Finding a File
Type part of a file name into Search filenames at the top right, then choose where to look:
- This folder searches the folder you are browsing.
- This folder + subfolders also searches every folder inside it.
- Entire library searches all folders in your media library.
The footer separates matches found from files displayed: 25 found · Showing 12 means more matches are available as you scroll. A spinning Searching… indicator shows that the search is still checking folders, with the current folder alongside it. Click Stop to end a recursive search, or clear the search field to return to browsing.
You can still use Upload, Edit image and Preview while searching. Uploads go into the folder you were browsing before the search, including when you search the entire library. Edit and Preview use the selected result.
You can also browse in grid or list view. Loading images… appears during initial loading; Loading more… appears while scrolling loads another portion.
Renaming a File
- Click a file in the Media Library.
- Look for an Edit or rename option in the file details panel.
- Update the file name and save.
Tip: Descriptive file names (like
team-photo-2024.jpginstead ofIMG_0042.jpg) make files easier to find later and can help with search engine visibility.
Deleting a File
- Click a file in the Media Library.
- Select Delete from the options.
- Confirm the deletion.
Warning: Deleting a file removes it from all pages where it is used. Before deleting, check whether the file appears in any content.
Best Practices for Images
File Size
Large image files slow down your website. Before uploading, resize images to be no larger than needed:
- For full-width banner images: 1920px wide maximum
- For content images: 1200px wide is usually sufficient
- For thumbnails: 400–600px wide
Use image compression tools (such as TinyPNG or Squoosh) to reduce file size before uploading without reducing visible quality.
Note: Images with very large pixel dimensions are rejected on upload, even when the file itself is small, because they use too much memory to process. If you see a message that an image's dimensions are too large, resize or downscale it (for example to 1920px wide) and upload it again. The default limit is 30 megapixels — roughly a 6500×4500 photo.
Images Too Large to Preview
An existing image may show Image too large to preview if its dimensions or processing needs exceed the preview limit. You can still select the original or click Preview to open it in the browser. To edit or generate smaller versions, downscale the original on your computer and upload the smaller image.
Image Format
- Use JPG for photos
- Use PNG for images with transparency
- Use WebP for the best compression (supported by all modern browsers)
- Use SVG for logos and icons
Naming Convention
Name your files clearly before uploading. Use lowercase letters and hyphens instead of spaces (e.g., about-team-2024.jpg, not About Team Photo.jpg).
Using Media in Content
Once a file is in the Media Library, you can insert it into:
- Pages — via the content editor toolbar
- Theme sections — via the header or footer editors
- SEO settings — the Open Graph image for social sharing
- Theme configuration — logo, favicon, and other site images