visuellverstehen/statamic-asset-atlas

Track where your Statamic assets are used to make moving, replacing and deleting them quick and easy.

v0.3.0 2025-09-23 07:49 UTC

Requires

• php: ^8.3
• laravel/framework: ^11 || ^12
• statamic/cms: ^5.0

Requires (Dev)

• laravel/pint: ^1.25
• orchestra/testbench: ^10.0
• pestphp/pest: ^4.1
• spatie/laravel-ray: ^1.40

MIT

• visuellverstehen

• assets
• addon
• delete
• replace
• statamic
• move

README

Track where your Statamic assets are used to make moving, replacing and deleting assets quick and easy.

Requirements

This package is based on using a database. It doesn't matter if you use the database for Statamic or not, but AssetAtlas tracks all asset references in entries, terms, global-sets and users as database records. This can be a simple SQLite database as it is preset in current Laravel installations.

How to use

Install the package:

composer require visuellverstehen/statamic-asset-atlas

Publish and run the required migration:

php artisan vendor:publish --tag=asset_atlas_migrations
php artisan migrate

Now whenever you save an item that relates to an asset, the reference is tracked in AssetAtlas. On moving, deleting or replacing an asset, AssetAtlas provides all references to the asset instead of the base Statamic logic of checking all possible items.

You can (and should) initialise the atlas using this command:

php please asset-atlas:scan

As records will be updated, you can use this command regularly to keep AssetAtlas up to date. Note that this command currently doesn't remove unused references. However, you can clear the atlas before scanning by using the reset parameter:

php please asset-atlas:scan --reset

# Use (the) force if you don't want to bother with confirmation dialogues:
php please asset-atlas:scan --reset --force

More about us

At visuellverstehen we create innovative digital and design solutions with a special focus on the common good. With technical expertise, high creativity and strategic skills, we develop products with a personal character.

• www.visuellverstehen.de
• www.visuellverstehen.de/en

License

The MIT license (MIT). Please take a look at the license file for more information.