In this section · 14 articles

File upload settings

The file types and the largest file size allowed for images, documents, archives and every other upload, with the defaults a new installation starts with.

Applies to
Core 12.0 and later
Who can do this
Administrator, Platform owner
Where
Configurations › General Settings › File Uploads
On this page

The Uploads panel sets what people may upload in Laramin's file fields. You need feature.core.uploads.edit to change it. Each field that accepts a file uses one of four groups, called upload profiles. A logo field, for example, uses Images.

SectionFieldDefaultNotes
ImagesImage Extensionsjpg, jpeg, png, gif, svg, webpSuggestions include bmp, avif and ico.
Image Max Size5MB
DocumentsDocument Extensionspdf, doc, docx, xls, xlsx, csv, txtSuggestions include ppt, pptx, odt and rtf.
Document Max Size10MB
ArchivesArchive Extensionszip, rar, 7z, gz, tarSuggestions include bz2.
Archive Max Size50MB
DefaultDefault Extensionsjpg, jpeg, png, gif, svg, webp, pdf, doc, docx, zipUsed by any file field that doesn't name one of the groups above.
Default Max Size10MB
The Uploads panel with Images, Documents, Archives and Default sections, each listing its allowed extensions as chips and a max size of 5, 10, 50 and 10 MB.

How to fill in the fields

  • Extensions: type each extension without the dot, for example jpg, and press Enter. You can pick from the suggestions or add your own. Up to 1,000 characters in all.
  • Max size: enter a positive number and choose KB, MB or GB, for example 5 MB. Decimals are allowed. Anything else is refused with Enter a positive number followed by KB, MB or GB.

A field left empty uses the default shown in the table. The panel shows the default when nothing has been saved yet.

What these settings don't change

Some uploads keep fixed limits of their own, whatever you set here:

UploadAllowedLargest file
App icon on the System panelpng, webp2MB
A static option's Imagejpg, jpeg, png, svg, webp2MB
An addon packagezip100MB

A CSV import has its own limit of 10 MB.

Your server has an upload limit of its own (PHP's upload_max_filesize and post_max_size), and a file over it is refused whatever you set here. If large uploads fail, ask whoever manages your server to raise it. [Confirm: the server upload limit on hosted installations.]

Careful: Allowing svg lets people upload images that can contain scripts. Only allow it if you trust everyone who can upload.