Media library
Uploading and organising files — accepted types, size limits, the filenames SeedWebs stores, folders, storage by plan, and the trash.
Last updated 2026-08-11
Every image, document, audio file and video your site uses lives in one library, under Media at /admin/media. You can upload from that page, or from the image picker while editing content — either way the file lands in the same library.
The library is available on every plan and to every role (super_admin, admin, editor, writer). What the plan changes is storage; what the role changes is deleting.
The pages under Media
| Item | URL | For |
|---|---|---|
| All Media | /admin/media | The grid of every file: upload, multi-select, trash |
| Folders | /admin/media/folders | Your folders, and the Add Folder button |
| Edit folder | /admin/media/folders/{id} | Rename, change the slug, delete |
| File detail | /admin/media/{id} | URL, size, type; edit Title/Folder; delete |
All Media shows 40 files per page, newest first. Beyond one page there are Previous / Next buttons at the bottom with “Page X of Y” and the total count.
The library and the file detail page are always in English, even with the admin panel set to Thai. What is translated is the sidebar item and the multi-select toolbar.
Accepted file types
| Group | Extensions |
|---|---|
| Images | jpg, jpeg, png, gif, ico, webp |
| Documents | pdf, doc, docx, ppt, pptx, pps, ppsx, odt, xls, xlsx |
| Audio | mp3, m4a, ogg, wav |
| Video | mp4, m4v, mov, wmv, avi, mpg, ogv, 3gp, 3g2 |
| Fonts | woff2 |
64 MB per file. Over that and you get “File too large. Maximum size is 64MB.” An extension outside the list gives “File type .xxx is not allowed. Allowed: images, svg, documents, audio, video, woff2”.
The server does accept .svg, and strips any script out of an SVG before storing it — but the Upload button on the Media page does not list .svg in its file filter. For an SVG site icon, use the Favicon field under Settings → General (/admin/settings/general), which takes .png, .ico, .svg and .webp up to 512 KB. That field needs admin or super_admin.
The picker you open from a content form — a featured image, say — accepts images only on its Upload tab; anything else you select is skipped. To upload a PDF or a video, use the Upload button at /admin/media.
Images are resized and converted for you
When you upload an image, your browser processes it before it goes to the server:
- Converted to WebP
- Resized so the longest side is at most 2400 pixels (smaller images are not enlarged)
- If the original was over 800 pixels on either side, a second file for phones is generated at up to 800 pixels, its name ending
-sm
GIF and ICO are neither converted nor given a mobile file, since a GIF may be animated. Non-images — documents, audio, video, fonts — upload exactly as they are.
The size checked against the 64 MB limit is the size after conversion, so photos from a camera or phone usually shrink a lot on the way in.
The filename SeedWebs stores
A library file’s URL looks like this, where {slug} is your site’s subdomain name (not the Site Name from Settings), and the year/month is when it was uploaded:
https://seedcdn.com/{slug}/media/2026/08/logo.webpThe filename is decided in this order:
- If the original name (without its extension) uses only English letters, digits, dots, hyphens and underscores, it is kept exactly — capitals included.
- If it contains spaces, Thai characters or anything else, it is slugified: lowercased, with spaces becoming hyphens.
- If that leaves no usable characters at all — a name written entirely in Thai — SeedWebs assigns a random 8-character name.
Duplicate names never overwrite each other. If the same year/month folder already has that name, a counter is appended — -1, -2, and so on. Once the same name has been used 20 times in one month, the next file gets a random suffix instead.
| File you upload | What is stored |
|---|---|
logo.png | logo.webp |
Hero-Banner.jpg | Hero-Banner.webp (capitals kept) |
my photo.jpg | my-photo.webp |
ใบเสร็จ.pdf | A random name, such as k3f9d2ab.pdf |
logo.png again in the same month | logo-1.webp |
The library’s Title field always keeps the original filename (without the extension), so a Thai-named file is still findable by its original name even when its URL is a random code. For a readable URL, rename the file in English before uploading — a URL cannot be changed afterwards from the admin panel.
Folders
Folders are grouping labels inside the admin panel only. A file’s URL always follows the year/month it was uploaded, so moving a file between folders never breaks an image link.
- The General folder is created with your site. It can be renamed, but its slug cannot change and it cannot be deleted.
- Add one at Media → Folders → Add Folder (
/admin/media/folders/new). Type a Name and the Slug fills itself in. - An upload goes into whichever folder you are filtering by. On “All”, it goes to General.
- To move a file later, open its detail page, press Edit and choose a Folder.
- To rename or delete a folder, click its name on the Folders page. Delete is there.
- Deleting a folder moves its files to General. They are not deleted with it.
- Folders are listed A-Z.
Creating and editing folders is open to editor and above. Deleting a folder needs admin or super_admin.
The file detail page
Click a file in the grid to open it. The File Information box shows:
- Title — the display and search name
- Folder — where it currently sits
- URL — the file link, with a copy button
- URL Mobile — the phone-sized link, shown when the file has one
- Type, Size, and Created; Updated appears once the file has been edited after upload
Press Edit to change Title and Folder, then Save. The Delete button in Edit mode moves the file to the trash.
If the file is in use, a Used In section lists what uses it, with links to edit. It checks featured images on posts, pages, events, products, books and docs; profile images on staffs and members; product gallery images; and product variation images. Only content types your site actually has appear — with no products or members, those two are simply absent.
Used In does not cover images embedded in post content, in HTML Builder, in a theme, or in custom fields that store a URL. Before deleting a file permanently, check the real pages yourself as well.
Searching the library
Search media… filters by Title among the files on the page you are on. If the library runs to several pages and you cannot find something, narrow the folder or change page first. The picker in content forms behaves the same way (20 files per page) and shows images only.
The image picker (Upload / Library / URL / Unsplash)
Everywhere you choose an image — a Featured Image on a post or page, the site logo, a gallery, an image in content — opens this same window.
| Tab | For |
|---|---|
| Upload | Upload a new image (images only) into the selected folder |
| Library | Pick from the library, filtered by folder and searched by Title |
| URL | Paste a link to an external image, with a preview |
| Unsplash | Search Unsplash’s free photos and pull one into your library |
The URL tab is not everywhere: a field like Featured Image stores a library file id, so it cannot take an external link. The places that do have it are:
- images inside an HTML Builder content card (it opens on the URL tab with the current link filled in)
- the Image field of a post category, at Posts → Categories (
/admin/posts/categories) - a banner’s image, at Settings → Banners (
/admin/settings/banners)
An external link means the file is not in your library. If it is deleted at the other end, the image disappears from your site.
The Unsplash tab
Unsplash is a free photo library. Opening the tab shows popular photos; type to search. One click pulls a photo into your library.
- You get a WebP up to 2400 pixels wide, plus an 800-pixel mobile file.
- The filename is a random code, and the Title is set to the photo’s description followed by “Photo by
on Unsplash”. - After a successful import the window switches to the Library tab with that photo selected.
If the tab says “Unsplash not configured”, the platform’s Unsplash connection has not been set up — contact the SeedWebs team. Uploading and the rest of the library work as normal.
Mobile files and srcset in a theme
The -sm file lets a theme send a smaller image to a small screen. The stock theme already does this in its post cards. Editing a theme yourself, these are the tags:
| Tag | Gives you |
|---|---|
{{item.featured_image}} | The featured image link |
{{item.featured_image_mobile}} | The -sm version of it |
{{item.featured_image_srcset}} | A ready srcset value: the normal file at 1200w and the -sm file at 768w |
{{item.field.xxx_mobile}}, {{item.field.xxx_srcset}} | The same, for custom fields holding an image link |
_mobile and _srcset are only derived for filenames ending .webp, .jpg, .jpeg or .png. The other tags are in Template tags, and themes in Themes and templates.
Storage by plan
| Plan | Storage |
|---|---|
| trial | 200 MB |
| Seed | 200 MB |
| Pro | 20 GB |
| Business | 200 GB |
| expired_trial | 200 MB |
A usage bar sits at the top of the Media page. Hover the i icon for your real figure and your site’s limit. It turns yellow at 70% and red at 90%.
When storage is full, uploads are refused with “Storage limit reached.” plus your usage and limit. The fixes are deleting unused files and emptying the trash, or upgrading — see Plans and billing.
Files in the trash still count toward your usage, because they are still stored until you empty it.
The trash
Deleting happens in two steps, so a misclick cannot break images on your live site.
- Move to Trash — the file leaves the library and cannot be selected again, but it still exists. Its link still works, and pages already using it still show it.
- Empty Trash — the file is deleted from storage. It cannot be recovered from the admin panel, and any page still referencing it shows a broken image.
To move files to the trash:
- One file: open its detail page, press Edit, then Delete.
- Several: hover a file in the grid, tick the box in its top-left corner, and use Move to Trash in the bar that appears.
Once anything is in the trash, a Trash (count) item appears in the left column under the folder list. Hovering a file there gives two buttons: Restore puts it back in the library, and the red bin deletes that one file permanently. Empty Trash at the top right deletes everything in the trash at once. Both ask for confirmation.
The trash is never emptied automatically — files stay until you say so. When it empties, the Trash item disappears and you are returned to the library.
Who can do what
| Action | Roles |
|---|---|
| Browse, upload, edit Title/Folder | super_admin, admin, editor, writer |
| Move a single file to the trash | super_admin, admin, editor, writer |
| Multi-select then Move to Trash | super_admin, admin |
| Restore from the trash | super_admin, admin, editor |
| Delete one file permanently, and Empty Trash | super_admin, admin |
| Create / edit a folder | super_admin, admin, editor |
| Delete a folder | super_admin, admin |
An editor may see the multi-select bar, but a multi-file Move to Trash is refused — delete them one at a time from the detail page instead. Roles are described in Users and permissions.
Common problems
| What you see | Cause and fix |
|---|---|
| ”File type .xxx is not allowed.” | The extension is not supported. Convert first — .tiff to .jpg, for instance |
| ”File too large. Maximum size is 64MB.” | Still over 64 MB after conversion, usually a video. Compress it or make it shorter |
| ”Storage limit reached.” | Your plan’s storage is full. Delete unused files and empty the trash, or upgrade |
| Selected several files but not all arrived | Uploads run one at a time and stop at the file that failed. Read the message, fix that file, upload the rest again |
| The uploaded filename became a random code | The original name was entirely Thai. Rename it in English before uploading |
| Search finds nothing although the file exists | Search only filters the page you are on. Choose a folder or change page first |
| Deleted a file but the image is still on the site | The file is in the trash and not yet deleted. Empty Trash if you really mean it |
| An image on the site is now broken | The file was deleted permanently. Upload it again and re-select it on that content |