# Configuration reference

All settings are reached through the **Options** button at the top right of every Media Organizer view. This page lists every option with its default.

<figure id="bkmrk-the-options-are-divi"> ![The options dialogue of Media Organizer with the tabs of the individual areas](https://docs.graup-it.de/uploads/images/gallery/2026-08/NLHdoku-11-optionen.png) <figcaption>The options are divided into seven tabs.</figcaption></figure><div class="callout info" id="bkmrk-the-defaults-are-del">The defaults are deliberately cautious and suitable for most websites. Change only what you have understood — especially in the tab *security &amp; retention*.

</div>## Scanning

Here you switch the search areas on and off. All of them are active by default.

<table class="table" id="bkmrk-optiondefaultmeaning"> <thead> <tr><th scope="col">Option</th><th scope="col">Default</th><th scope="col">Meaning</th></tr> </thead> <tbody> <tr><td>Articles and categories</td><td>Yes</td><td>Articles (intro/full text, article image) and categories.</td></tr> <tr><td>Modules</td><td>Yes</td><td>Module HTML, module settings and folder entries.</td></tr> <tr><td>Scan version history</td><td>Yes</td><td>Count hits in the version history as referenced.</td></tr> <tr><td>Template files</td><td>Yes</td><td>Images hard-coded in CSS and template files.</td></tr> <tr><td>Extension profiles</td><td>Yes</td><td>Third-party extensions with a profile.</td></tr> <tr><td>Deep scan</td><td>Yes</td><td>Catch-all scan across all database tables.</td></tr> <tr><td>Active media types</td><td>Image</td><td>Which types are inventoried: image, document, video, audio, font, archive, other.</td></tr> <tr><td>Available profiles</td><td>—</td><td>Display only: which profiles exist.</td></tr> </tbody></table>

## Scan – advanced

<table class="table" id="bkmrk-optiondefaultmeaning-1"> <thead> <tr><th scope="col">Option</th><th scope="col">Default</th><th scope="col">Meaning</th></tr> </thead> <tbody> <tr><td>Root directories</td><td>empty</td><td>Which media adapters are inventoried. Empty = the default adapter `local-images`. For media under `media/`, create a directory there in the media component and enter the adapter here.</td></tr> <tr><td>Excluded paths</td><td>empty</td><td>One entry per line. A folder path excludes the folder including subfolders; glob patterns such as `*.tmp` work too.</td></tr> <tr><td>Protected core folders</td><td>`administrator, api, bin, cache, cli, components, includes, installation, jimgo_quarantine, language, layouts, libraries, modules, plugins, templates, tmp`</td><td>Never recorded. Protection against deleting system files. `media/` is deliberately not among them.</td></tr> <tr><td>Deep scan: excluded tables</td><td>empty</td><td>In addition to the built-in exclusions.</td></tr> <tr><td>Media-free extensions</td><td>empty</td><td>Components without media references. They count as covered.</td></tr> <tr><td>Detected media-free extensions</td><td>—</td><td>Display only: extensions already verified.</td></tr> <tr><td>Count the trash</td><td>Yes</td><td>Items in the trash reference their files as well.</td></tr> <tr><td>Count unpublished items</td><td>Yes</td><td>Unpublished items likewise.</td></tr> <tr><td>Count module folders</td><td>Yes</td><td>Treat folder parameters as folder references.</td></tr> <tr><td>Custom field media types</td><td>`media, imagelist, mediajce, mediafile, acfgallery, acfupload, acfdownloadbutton, acfhtml5audio, acfvideo`</td><td>Which custom field types contain media. Used but not searched ⇒ deleting stays blocked.</td></tr> <tr><td>Normalise Unicode (NFC)</td><td>Yes</td><td>Unifies umlauts before comparing. Leave it on when in doubt.</td></tr> <tr><td>Known website URLs</td><td>empty</td><td>One URL per line. Absolute URLs on these hosts count as local.</td></tr> </tbody></table>

## Security &amp; retention

<div class="callout warning" id="bkmrk-this-tab-controls-wh">This tab controls when deleting is allowed at all. Every relaxation here lowers your safety net.

</div><table class="table" id="bkmrk-optiondefaultmeaning-2"> <thead> <tr><th scope="col">Option</th><th scope="col">Default</th><th scope="col">Meaning</th></tr> </thead> <tbody> <tr><td>Retention: images</td><td>30 days</td><td rowspan="6">For this long a file of this type has to sit in quarantine before it *may* be deleted. **0 = never released automatically.** The period is a precondition, not a trigger — after it expires, nothing happens by itself.</td></tr> <tr><td>Retention: documents</td><td>180 days</td></tr> <tr><td>Retention: video</td><td>90 days</td></tr> <tr><td>Retention: audio</td><td>90 days</td></tr> <tr><td>Retention: fonts</td><td>0 (never)</td></tr> <tr><td>Retention: archives / other</td><td>180 days</td></tr> <tr><td>Require a super user for deleting</td><td>Yes</td><td>Restrict deleting for good to super users.</td></tr> <tr><td>Maximum scan age</td><td>7 days</td><td>An older scan cannot authorise deleting.</td></tr> <tr><td>Minimum number of consecutive scans</td><td>2</td><td>A file has to have been a candidate this many times in a row before it may be deleted.</td></tr> <tr><td>Validity of the confirmation token</td><td>300 seconds</td><td>How long a confirmation token stays valid.</td></tr> <tr><td>Override the deletion block</td><td>No</td><td>Super users only. Allows deleting despite incomplete coverage. Is recorded.</td></tr> <tr><td>Reason for the override</td><td>empty</td><td>Mandatory reason, stored along with it.</td></tr> <tr><td>Quarantine root</td><td>`jimgo_quarantine`</td><td>Where files are moved to. Protected with deny files on first use. **Do not use the cache folder** — it gets emptied. A warning appears if it is inside the web root.</td></tr> </tbody></table>

## Optimisation

**Thresholds for the report** — they only decide what is *reported*:

<table class="table" id="bkmrk-maximum-file-size500"> <tbody> <tr><td>Maximum file size</td><td>500 KB</td><td>Larger files are flagged. 0 = off.</td></tr> <tr><td>Maximum edge length</td><td>2500 px</td><td>Larger images are flagged. 0 = off.</td></tr> <tr><td>Outdated formats</td><td>`bmp, tif, tiff`</td><td>Are flagged as outdated.</td></tr> <tr><td>Modernise from</td><td>150 KB</td><td>Raster images above this count as WebP/AVIF candidates. 0 = off.</td></tr> <tr><td>Raster formats to modernise</td><td>`jpg, jpeg, png, gif`</td><td>Which formats could change.</td></tr> </tbody></table>

**How optimisation works:**

<table class="table" id="bkmrk-image-libraryautomat"> <tbody> <tr><td>Image library</td><td>Automatic</td><td>Prefers Imagick, falls back to GD.</td></tr> <tr><td>Maximum edge length (px)</td><td>2560</td><td>Scale down from this edge. Never scales up. 0 = off.</td></tr> <tr><td>JPEG quality</td><td>82</td><td>1–100. Around 80 is a good compromise.</td></tr> <tr><td>PNG compression</td><td>8</td><td>0–9, lossless. Higher = smaller and slower.</td></tr> <tr><td>WebP quality</td><td>82</td><td>When the source is already WebP.</td></tr> <tr><td>Remove metadata</td><td>Yes</td><td>Remove EXIF, ICC and comments.</td></tr> <tr><td>Minimum saving</td><td>10 %</td><td>Below that the original stays untouched.</td></tr> <tr><td>Maximum source pixels</td><td>0 (automatic)</td><td>Skip images that are too large, so that decoding stays within memory. 0 derives the limit from the PHP memory limit — recommended.</td></tr> <tr><td>Images per step</td><td>5</td><td>How many images are optimised per request.</td></tr> <tr><td>Editor export quality</td><td>82</td><td>Default quality for images from the editor.</td></tr> <tr><td>Backup location</td><td>`jimgo_optimize_backup`</td><td>Where originals are backed up before optimisation. Is protected.</td></tr> </tbody></table>

**External optimisers** (optional, see the chapter of its own):

<table class="table" id="bkmrk-use-external-optimis"> <tbody> <tr><td>Use external optimisers</td><td>Yes</td><td>Uses pngquant, oxipng, jpegoptim, cwebp, gifsicle where available. Falls back automatically when a tool is missing.</td></tr> <tr><td>Optimiser directory</td><td>empty</td><td>Empty = search the system PATH. Nothing is downloaded or shipped along.</td></tr> <tr><td>Available optimisers</td><td>—</td><td>Display only: what was detected.</td></tr> <tr><td>JPEG / PNG / WebP / GIF optimiser</td><td>Automatic</td><td>Which tool per format. For PNG: pngquant is lossy (the biggest saving), oxipng and OptiPNG are lossless.</td></tr> <tr><td>PNG minimum / target quality</td><td>60 / 82</td><td>pngquant limits. If the minimum quality is not reached, the PNG stays unchanged.</td></tr> </tbody></table>

## Reports &amp; view

<table class="table" id="bkmrk-entries-per-page50de"> <tbody> <tr><td>Entries per page</td><td>50</td><td>Default page size of all lists. The selection in the page footer takes precedence.</td></tr> <tr><td>Hide providers from broken references</td><td>`history`</td><td>Their hits never appear as a broken reference.</td></tr> <tr><td>History tables</td><td>`#__history`</td><td>Deep scan hits in them do not count as a broken reference.</td></tr> </tbody></table>

## Performance

<table class="table" id="bkmrk-files-per-scan-step2"> <tbody> <tr><td>Files per scan step</td><td>200</td><td>How many files one scan step records and checks. Smaller = shorter steps, needed with a tight time limit. See [Large websites and tight time limits](https://docs.graup-it.de/books/media-organizer-en/page/large-websites-and-tight-time-limits).</td></tr> <tr><td>Records per scan step</td><td>500</td><td>How many articles, modules and other records one step searches for references.</td></tr> <tr><td>Maximum time per scan step</td><td>10 s</td><td>Safety net: a step ends after this time at the latest, even if the configured amount has not been reached. 0 disables the time limit.</td></tr> <tr><td>Database chunk (rows)</td><td>500</td><td>How many rows the scan reads at once. Smaller = gentler on memory.</td></tr> <tr><td>Keep scan detail data</td><td>2</td><td>For how many of the last scans the occurrence details are kept. Only the latest scan is ever displayed anyway; higher values grow the database without showing you more. The scan overview is kept regardless.</td></tr> <tr><td>Calculate file hashes</td><td>Yes</td><td>Needed for duplicates and to detect changes. Switching it off makes the scan minimally faster — and the deletion gate blinder.</td></tr> <tr><td>Cache thumbnails</td><td>Yes</td><td>Creates scaled-down previews under `media/com_jimgo/thumbs`. Requires PHP GD.</td></tr> <tr><td>Thumbnail size</td><td>360 px</td><td>Longest edge of the thumbnails.</td></tr> </tbody></table>

## Permissions

The standard Joomla tab. See [Permissions, export and privacy](https://docs.graup-it.de/books/media-organizer-en/page/permissions-export-and-privacy).

<small>Applies to version 1.2.0.</small>

[Deutsche Fassung](https://docs.graup-it.de/link/69)