# Image upload

/dashboard/settings/image-upload

# Enabled image formats

Determines which image formats can be uploaded.

Formats supported

JPG PNG BMP GIF WEBP

# Enable uploads

Toggles the image upload functionality.

# Upload user interface

Determines how the upload will be displayed.

Value Effect
On-page container Uses a JS uploader that stays in page
/upload route Drives users towards the upload page

# Guest uploads

Same as enable uploads, but for guest users.

# Moderate uploads

Determines if incoming uploads must be moderated or not.

Value Effect
Disabled No moderation required
Guest Moderate guest uploads
All Moderate all uploads

# Enable embed codes (uploader)

Toggles the display of embed codes after upload process.

# Upload threads

Determines the number of parallel threads used by the uploader. This setting should be configured according to the installed hardware and the usage of your website.

# Redirect on single upload

Toggles the HTTP redirection on single image upload. When enabled, users will be redirected to the image viewer.

WARNING

This should be disabled if upload moderation is enabled. This is because the viewer URL will return HTTP 403 until the image gets approved.

# Enable duplicate uploads

Toggles the acceptance of duplicate uploads.

# Enable expirable uploads

Toggles the availability of expirable uploads, which will get automatically removed after a certain date.

# Auto delete guest uploads

Determines the automatic deletion of guest uploads.

# Maximum image size

Determines the maximum size (in pixels) allowed for image uploads. Larger images will get automatically downscale.

# Image Exif data

Toggles the handling of image Exif (opens new window) data.

# Image Exif data (user setting)

Toggles if users can determine how to handle Exif data.

# Maximum upload file size [MB]

Determines the maximum image size allowed.

WARNING

This setting is capped by local php.ini configuration.

# Maximum upload file size (guests)

Same as above, but for guests.

# Image path

The file system path for storing uploads.

# Storage mode

How uploads will get organized in the file system.

Value Effect
Datefolders Uses a nested folder structure YYYY/MM/DD
Direct No folder structure

TIP

This setting only affects future uploads. Previous uploads won't be affected.

# File naming method

How uploads will be named on upload.

  • Source file: ./DSC-1313.jpg
Value Effect Example
Original Keep the original file name (will randomize on collisions) DSC-1313.jpg
Random A randomized alphanumeric name bJdrpmdfi.jpg
Mix original + random Keep part of the original filename DSC-13pLfm.jpg
ID Name the uploads as their public (encoded) ID kIf.jpg

# Thumb size

The with and height for the image thumbs.

# Medium image fixed dimension

Determines how medium images will be generated by specifying the resizing criteria.

Value Effect
Width Resizing fixing width to the target value
Height Resizing fixing height to the target value

# Medium image fixed size

The medium image size. Images will be resized based on the medium image fixed dimension criteria.

# Watermarks

Toggles image watermarking, which are images that are merged in front of the images. Useful for any branding need.

TIP

Watermark settings below applies only if Watermarks is Enabled.

# Watermark user toggles

Which user uploads will be watermarked.

# Watermark file toggles

Which image formats will be watermarked.

# Minimum image size needed to apply watermark

Determines the minimum image size criteria needed to watermark an image.

# Watermark image

The image used to watermark image uploads.

Type Recommended
Image PNG with alpha transparency

# Watermark position

The area where the watermark will be applied to the image.

Left top Center top Right top
Left center Center center Right center
Left bottom Center bottom Right bottom

# Watermark percentage

The watermark size expressed in percentage of the target area.

# Watermark margin

A margin to implement around the watermark. Useful if the watermark is not implemented at center/center.

# Watermark opacity

The opacity of the watermark image.