---
title: "Maintenance"
manual: "Image Optimization for TYPO3"
version: "1.6"
permalink: "https://docs.typo3.org/permalink/netresearch/nr-image-optimize:maintenance@1.6"
source: "Maintenance/Index.rst"
rendered: "2026-09-25T10:18:05+00:00"
---

# Maintenance {#maintenance}

The extension provides a backend module accessible via
**Admin Tools > Processed Images Maintenance**.

## Overview {#maintenance-overview}

View statistics about processed images:

-   File count and total size.
-   Directory count.
-   Largest files.
-   File type distribution.

## System requirements check {#maintenance-system-requirements}

Verify all technical prerequisites and tool availability:

-   PHP version and extensions (Imagick, GD).
-   ImageMagick / GraphicsMagick capabilities (WebP, AVIF
    support).
-   Composer dependencies (Intervention Image).
-   TYPO3 version compatibility.
-   CLI tools (`magick`, `convert`, `identify`, `gm`
    -- optional).

## Invalidate by path {#maintenance-invalidate-path}

Delete only the processed variants derived from a given original
file path, a directory prefix (trailing `/`), or a glob pattern
(`*`/`?`) -- similar to a CDN cache invalidation, instead of
clearing the whole "processed" directory. Confirms before deleting
and reports the number of files removed.

## Clear processed images {#maintenance-clear}

Remove all on-demand generated images. Images are regenerated
automatically when first accessed again.

> [!WARNING]
> After clearing processed images, expect temporarily
> increased loading times on the frontend until images are
> regenerated on demand.
