WirdAll synchronisiertsettings …are reached through the Options button at the top right of every Media
Organizer view. This page lists every option with its default.
The options are divided into seven tabs.
The defaults are deliberately cautious and suitable for most websites. Change only what you have
understood — especially in the tab security & retention.
Scanning
Here you switch the search areas on and off. All of them are active by default.
OptionDefaultMeaning
Articles and categoriesYesArticles (intro/full text, article image) and categories.
ModulesYesModule HTML, module settings and folder entries.
Scan version historyYesCount hits in the version history as referenced.
Template filesYesImages hard-coded in CSS and template files.
Extension profilesYesThird-party extensions with a profile.
Deep scanYesCatch-all scan across all database tables.
Active media typesImageWhich types are inventoried: image, document, video, audio, font, archive, other.
Available profiles—Display only: which profiles exist.
Scan – advanced
OptionDefaultMeaning
Root directoriesemptyWhich 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.
Excluded pathsemptyOne entry per line. A folder path excludes the folder including subfolders; glob patterns such as *.tmp work too.
Protected core foldersadministrator, api, bin, cache, cli, components, includes, installation, jimgo_quarantine, language, layouts, libraries, modules, plugins, templates, tmpNever recorded. Protection against deleting system files. media/ is deliberately not among them.
Deep scan: excluded tablesemptyIn addition to the built-in exclusions.
Media-free extensionsemptyComponents without media references. They count as covered.
Detected media-free extensions—Display only: extensions already verified.
Count the trashYesItems in the trash reference their files as well.
Count unpublished itemsYesUnpublished items likewise.
Count module foldersYesTreat folder parameters as folder references.
Custom field media typesmedia, imagelist, mediajce, mediafile, acfgallery, acfupload, acfdownloadbutton, acfhtml5audio, acfvideoWhich custom field types contain media. Used but not searched ⇒ deleting stays blocked.
Normalise Unicode (NFC)YesUnifies umlauts before comparing. Leave it on when in doubt.
Known website URLsemptyOne URL per line. Absolute URLs on these hosts count as local.
Security & retention
This tab controls when deleting is allowed at all. Every relaxation here lowers your safety
net.
OptionDefaultMeaning
Retention: images30 daysFor 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.
Retention: documents180 days
Retention: video90 days
Retention: audio90 days
Retention: fonts0 (never)
Retention: archives / other180 days
Require a super user for deletingYesRestrict deleting for good to super users.
Maximum scan age7 daysAn older scan cannot authorise deleting.
Minimum number of consecutive scans2A file has to have been a candidate this many times in a row before it may be deleted.
Validity of the confirmation token300 secondsHow long a confirmation token stays valid.
Override the deletion blockNoSuper users only. Allows deleting despite incomplete coverage. Is recorded.
Reason for the overrideemptyMandatory reason, stored along with it.
Quarantine rootjimgo_quarantineWhere 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.
Optimisation
Thresholds for the report — they only decide what is reported:
Maximum file size500 KBLarger files are flagged. 0 = off.
Maximum edge length2500 pxLarger images are flagged. 0 = off.
Outdated formatsbmp, tif, tiffAre flagged as outdated.
Modernise from150 KBRaster images above this count as WebP/AVIF candidates. 0 = off.
Raster formats to modernisejpg, jpeg, png, gifWhich formats could change.
How optimisation works:
Image libraryAutomaticPrefers Imagick, falls back to GD.
Maximum edge length (px)2560Scale down from this edge. Never scales up. 0 = off.
JPEG quality821–100. Around 80 is a good compromise.
PNG compression80–9, lossless. Higher = smaller and slower.
WebP quality82When the source is already WebP.
Remove metadataYesRemove EXIF, ICC and comments.
Minimum saving10 %Below that the original stays untouched.
Maximum source pixels0 (automatic)Skip images that are too large, so that decoding stays within memory. 0 derives the limit from the PHP memory limit — recommended.
Images per step5How many images are optimised per request.
Editor export quality82Default quality for images from the editor.
Backup locationjimgo_optimize_backupWhere originals are backed up before optimisation. Is protected.
External optimisers (optional, see the chapter of its own):
Use external optimisersYesUses pngquant, oxipng, jpegoptim, cwebp, gifsicle where available. Falls back automatically when a tool is missing.
Optimiser directoryemptyEmpty = search the system PATH. Nothing is downloaded or shipped along.
Available optimisers—Display only: what was detected.
JPEG / PNG / WebP / GIF optimiserAutomaticWhich tool per format. For PNG: pngquant is lossy (the biggest saving), oxipng and OptiPNG are lossless.
PNG minimum / target quality60 / 82pngquant limits. If the minimum quality is not reached, the PNG stays unchanged.
Reports & view
Entries per page50Default page size of all lists. The selection in the page footer takes precedence.
Hide providers from broken referenceshistoryTheir hits never appear as a broken reference.
History tables#__historyDeep scan hits in them do not count as a broken reference.
Performance
Database chunk (rows)500How many rows the scan reads at once. Smaller = gentler on memory.
Keep scan detail data5For how many of the last scans the occurrence details are kept. The scan overview is kept regardless.
Calculate file hashesYesNeeded for duplicates and to detect changes. Switching it off makes the scan minimally faster — and the deletion gate blinder.
Cache thumbnailsYesCreates scaled-down previews under media/com_jimgo/thumbs. Requires PHP GD.
Thumbnail size360 pxLongest edge of the thumbnails.
