Skip to main content

3 - Uploading files

Drag files onto the list, or click Upload. They land in the open folder, and every image is prepared for the web on the way.

What Iris does to each image

  • It brings it within a frame, 1600 × 1200 px by default: a 6000 px wide camera photo has no business on a web page. An image smaller than the frame is never enlarged. A very heavy photo is first reduced in the browser, so it gets past the server upload limit, a 25 MB photo included (from Iris 3.0.055).
  • It straightens it: a portrait photo taken with a phone keeps its orientation.
  • It converts it to WebP, much lighter than a JPEG or a PNG at equal quality. PNG transparency is kept.
  • It renames it following a pattern, {dossier}-{n} by default: news-12.webp rather than IMG_20260930_101512.jpg. A readable name also helps search engines. The default pattern was {site}-{dossier}-{n} up to 3.0.045; an updated site keeps its own.

Before uploading: the names

From Iris 3.0.056, a window opens before each upload. It shows the name each file will get, then offers:

  • Rename with the pattern (recommended);
  • Keep the original names, cleaned for the web: no accents, no spaces, lower case. IMG_20260930_101512.jpg becomes img-20260930-101512.webp.

It also says where the pattern is set, with a link to the Options for those allowed to change them. To stop seeing it: Options → Upload → Ask before uploading: No. Iris then renames without asking.

The log, below the list, says for each file what was done: scaled, from which dimensions to which, converted to WebP, size before and after.

GIF files (often animated) and SVG files are not transformed. Originals are not kept: upload a copy if you care about the original photo.

Documents

A document dropped into an image root goes to Files, and Iris tells you so. Accepted formats are those of the Joomla media manager, plus those Iris allows in its Options: recent Word, Excel and PowerPoint by default, SVG, 3D models and RAW photos on request.

Adjusting the processing

Everything is set in Options → Upload: renaming and its pattern (with a live example), the question before uploading, the frame, the quality, WebP conversion. See the Iris Options chapter.

Up to date for Iris 3.0.058. Features added after 3.0.045 show the version that brings them.