> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/norrcompetition/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/norrcompetition/configuration/images.md).

# Images

Image manipulation, dimensions, quality, cropping, watermarks, video thumbnails, and import settings.

The **Images** tab configures media processing libraries, image compression quality, dimensions for multiple responsive breakpoints, watermark overlays, video poster dimensions, and batch import handling.

### Photo Options

* **Image Library** (`graphiclib`) — Selects the PHP image processing library: *GD* or *ImageMagick (imagick)*. ImageMagick is recommended for superior image quality, faster batch processing, and accurate color profile handling.
* **Max File Size (KB)** (`image_max_file_size`) — Maximum allowed upload size for contestant photos in kilobytes (default: `2048` KB / 2 MB).
* **Image Quality** (`image_quality`) — Compression quality of generated JPEG/WebP images (range: `10` to `100%`, default: `90%`).
* **Big Image Dimensions** (`big_image_width`, `big_image_height`) — Maximum dimensions in pixels for full-size images displayed in the lightbox overlay (default: `1800 x 1800` px).
* **Medium Image Dimensions** (`med_image_width`, `med_image_height`) — Dimensions in pixels for the main photo displayed on the single entry details page (default: `600 x 600` px).
* **Small Image Dimensions** (`small_image_width`, `small_image_height`) — Dimensions in pixels for thumbnail cards displayed in contest grid/list views (default: `450 x 450` px).
* **Crop Small Image** (`image_crop`) — When enabled, presents an interactive cropping tool on the entry submission form allowing contestants to select the crop area.
* **Crop Aspect Ratio** (`crop_image_ratio`) — Enforces the aspect ratio during interactive cropping: `1:1` (Square), `2:3` (Portrait), `3:2` (Classic 35mm), `4:3` (Standard), `16:9` (Widescreen).
* **Preview Image Dimensions** (`preview_image_width`, `preview_image_height`) — Dimensions in pixels for the immediate upload preview in the frontend submission form (default: `450 x 450` px).

### Gallery Options (Additional Photos)

* **Thumbnail Width / Height** (`gallery_thumb_width`, `gallery_thumb_height`) — Dimensions in pixels for additional gallery thumbnails displayed on entry pages (default: `120 x 120` px).
* **Creation Method** (`gallery_thumb_method`) — Thumbnail generation algorithm:
  * *Scale* — Proportional scaling with black padding if needed to fill the frame.
  * *Crop* — Scales and centers the photo, cropping excess edges to fill the exact dimensions.

{% hint style="info" %}
Image dimension changes apply to newly uploaded photos. Existing images are preserved in their original processed dimensions.
{% endhint %}

### Watermark Options

* **Watermark Image** (`watermark`) — Select a PNG watermark file from the Joomla Media Manager to overlay onto uploaded contest photos.
* **Apply to Medium Image** (`watermark_med`) — When enabled, applies the watermark to both big lightbox images and medium entry page images (scaled proportionally).
* **Watermark Transparency** (`wm_transparency`) — Sets watermark opacity percentage (`0` = completely solid, `100` = fully transparent).
* **Right Margin** (`wm_margin_right`) — Distance in pixels from the right border of the photo (default: `10` px).
* **Bottom Margin** (`wm_margin_bottom`) — Distance in pixels from the bottom border of the photo (default: `10` px).

### Video Options

* **Video Thumbnail Dimensions** (`video_thumb_width`, `video_thumb_height`) — Dimensions in pixels for cached video poster thumbnails fetched from supported video providers (YouTube, Vimeo, etc.; default: `450 x 253` px, 16:9 ratio).

### Import Options

* **Resize Method on Import** (`import_resize_method`) — Image scaling strategy applied during batch entry data imports (*Scale* or *Crop*).