t3/size

Displays TYPO3 CMS storage usage information in the backend.

dev-master 2026-05-24 17:15 UTC

Requires

• php: ^8.2
• typo3/cms-backend: ^13.4 || ^14.3
• typo3/cms-core: ^13.4 || ^14.3

Requires (Dev)

• ext-zip: *
• armin/editorconfig-cli: ^2.2.1
• friendsofphp/php-cs-fixer: ^3.95.2
• jangregor/phpstan-prophecy: ^2.3
• phpstan/phpstan: ^2.1.55
• phpstan/phpstan-doctrine: ^2.0.22
• saschaegerer/phpstan-typo3: ^3.0.1
• typo3/cms-dashboard: ^13.4 || ^14.3
• typo3/cms-scheduler: ^13.4 || ^14.3

Replaces

• typo3-ter/size: *

GPL-2.0-or-later

• Armin Vieweg

• TYPO3 CMS
• file size
• database size
• Storage usage

README

Intro

TYPO3 CMS extension to display TYPO3 CMS storage usage information in the backend.

size gives editors and administrators a fast overview of project storage usage in TYPO3.

Features

• backend module with storage distribution for Media, Database, Code, and Misc
• dashboard widget and backend toolbar item based on the same snapshot data
• table with the 10 largest FAL files, including path and usage count
• CLI command and TYPO3 Scheduler support via size:refresh
• configurable total storage limit with percentage display
• warning and full email notifications
• PSR-14 extensibility for collected paths and snapshot manipulation

For PSR-14 events, payload details, and a listener example, see Documentation/EventListeners.md.

Requirements

• PHP ^8.2
• TYPO3 ^13.4 or ^14.3
• TYPO3 system extensions "dashboard" and "scheduler" for full feature usage

Installation

Install the extension via Composer:

composer require t3/size

After installation:

1. activate the extension in TYPO3 if required by your setup
2. execute the database/schema updates suggested by TYPO3
3. optionally add size:refresh as a Scheduler job

The extension provides the Symfony command:

php vendor/bin/typo3 size:refresh

Use this command manually or in TYPO3 Scheduler jobs to refresh the size overview.

Configuration

maximumTotalStorage

Defines the expected total capacity for the measured project storage and enables percentage display in the backend.

Examples:

• 250 MB
• 1 GB
• 1.5 GB

If set, the total section is rendered like Total: 165.32 MB / 250 MB (66.1%).

warningNotificationRecipients

Comma- or line-separated email addresses that receive a warning mail when the measured total is above 90% and below 100% of maximumTotalStorage.

fullNotificationRecipients

Comma- or line-separated email addresses that receive a full mail when the measured total is at or above 100% of maximumTotalStorage.

additionalMiscFolders

Comma- or line-separated relative project paths that should be measured as additional Misc rows.

Examples:

• packages
• public/uploads
• Build/cache

Configured paths must point into the TYPO3 project directory.