Cache Management

The CMS caches a lot of data (database queries, compiled views, menu trees, widgets, etc.) to keep the site fast. Over time the framework cache folder (storage/framework/cache) can grow large and start to slow things down instead of speeding them up. The Cache Management panel lets you inspect and clear each cache on demand, and configure an automatic cleanup.

Open the panel

Go to Admin → Platform Administration → Cache Management.

You will see:

• The current size of the framework cache folder
• A row for each cache type (CMS cache, compiled views, config cache, route cache, logs)
• A Performance Optimization card to pre-cache config/routes/views

If the cache exceeds the warning threshold, a yellow banner appears at the top of the page recommending that you clear it.

Configure cache behavior

Go to Admin → Settings → Cache.

The following options control how the framework cache is monitored and cleaned up:

Setting	Default	Purpose
Cache size warning threshold (MB)	50	Size (MB) above which the Cache Management page shows a warning banner.
Auto-clear cache when size exceeds threshold	Off	When enabled, the cache is cleared automatically if it grows past the warning threshold.

Auto-clear cache

When Auto-clear cache when size exceeds threshold is turned on, the CMS runs the cms:cache:auto-clear command every hour. If the framework cache folder exceeds the configured warning threshold, the command clears it — the same action as pressing Clear all CMS cache manually (framework cache + Google Fonts cache + HTML Purifier cache + debugbar storage).

If the cache is below the threshold, the command does nothing.

Requires a working scheduler

The hourly auto-clear depends on Laravel's scheduler. You must have this cron entry on your server:

* * * * * /usr/local/bin/php /path-to-your-project/artisan schedule:run >> /dev/null 2>&1

See Setup cronjob for instructions on common hosts (cPanel, Hostinger).

Manual command

You can trigger the check at any time from the CLI:

php artisan cms:cache:auto-clear

Output depending on state:

• Setting disabled → Auto-clear cache is disabled. Skipping.
• Size ≤ threshold → Cache size (X MB) is within the N MB threshold. No action taken.
• Size > threshold → Cache size (X MB) exceeded the N MB threshold. Clearing cache... followed by Framework cache cleared successfully.

Related commands

Command	What it does
php artisan cms:cache:auto-clear	Check framework cache size and clear it if it exceeds the configured threshold (only runs if auto-clear is enabled in settings).
php artisan cms:cache:clear-expired	Remove only expired cache files. Runs daily on its own if the scheduler is configured.
php artisan cache:clear	Flush all framework cache entries (Laravel built-in).
php artisan optimize:clear	Clear every Laravel cache (config, routes, views, events, compiled).