t3/size

Displays TYPO3 CMS storage usage information in the backend.

dev-master 2026-05-26 16:49 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
• optional history with 31 daily checkpoints plus all stored weekly and monthly aggregated checkpoints
• 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

The extension settings are grouped into two sections in the TYPO3 extension configuration:

• basic: Enable history, Additional Misc folders
• Storage Alerts: Maximum total storage, Warning notification recipients, Full notification recipients

Enable history (enableHistory)

Stores aggregated checkpoints for Media, Database, Code, Misc, and Total in sys_registry during recalculation. The extension keeps:

• 31 daily checkpoints
• all completed ISO weeks stored in the history
• all completed calendar months stored in the history

If disabled, no history entries are written and the week/month comparison UI is hidden.

Additional Misc folders (additionalMiscFolders)

Comma-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.

Maximum total storage (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%).

Also, this option is required to be set, to enable mail notifications.

Warning notification recipients (warningNotificationRecipients)

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

Full notification recipients (fullNotificationRecipients)

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