PHPackages flowpack/neos-asset-usage - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. flowpack/neos-asset-usage ActiveNeos-package[Utility & Helpers](/categories/utility) flowpack/neos-asset-usage ========================= Provides an asset usage service for the Neos CMS 0.3.3(1y ago)525.6k↓36.7%2[3 issues](https://github.com/Flowpack/Flowpack.Neos.AssetUsage/issues)1GPL-3.0-or-laterPHP Since Sep 15Pushed 6mo ago11 watchersCompare [ Source](https://github.com/Flowpack/Flowpack.Neos.AssetUsage)[ Packagist](https://packagist.org/packages/flowpack/neos-asset-usage)[ RSS](/packages/flowpack-neos-asset-usage/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (7)Dependencies (2)Versions (8)Used By (1) Asset usage tracking for Neos CMS ( <= 8.x) ============================================== [](#asset-usage-tracking-for-neos-cms---8x) This package provides a more performant replacement for the asset usage calculation in [Neos CMS](https://www.neos.io) 5.x, 7.x and 8.x. **In Neos >= 9.0, highly performant asset usage is included in the core, you do NOT need this package anymore then.** > **Upgrading to Neos 9** > > - remove the dependency to `flowpack/neos-asset-usage` > - there is no step 2 - that's it 🙂 Neos always calculated the asset usage when the information was requested. This could take quite long depending on the number of nodes and assets in a project. This package solves the problem by using the registration service of `Flowpack.EntityUsage`to register a usage if an asset is referenced and unregister when the asset is not referenced by a node anymore. The data is stored in a database table and can be efficiently queried and accessed by the provided service. Additionally, the package provides a replacement for the `AssetUsageInNodePropertiesStrategy`of Neos CMS. The core strategy is disabled via AOP. TLDR ---- [](#tldr) Viewing asset usages in Neos CMS will be super fast when this package is installed. Using it with `Flowpack.Media.Ui` will also allow enabling additional features like filtering for unused assets and delete button are disabled if an asset is used. Compatibility ------------- [](#compatibility) Neos 5.2, Neos 7.x + Neos 8.x Installation ------------ [](#installation) Add the package, and the storage as dependency in your site package: ``` composer require --no-update flowpack/neos-asset-usage flowpack/entity-usage-databasestorage ``` The run `composer update` in your project root. Finally you need to run the command to build the initial usage index: ``` ./flow assetusage:update ``` This will store all usages in your database. If you deploy your project on another system you have to make sure that you run this command there. It is recommended to run the command from time to make sure that no usages are in the database that don't exist anymore or usages are missing. When that happens, it is important that you try to find out where they come from. If you think this happened due to an error in this package, please open an issue with as much information as you can give. Feature: Exclude node types from usage count -------------------------------------------- [](#feature-exclude-node-types-from-usage-count) Possible use case: If you are using this package in combination with [neos/metadata-contentrepositoryadapter](https://github.com/neos/metadata-contentrepositoryadapter), the metadata entries will be recognized as usage count. You can adjust this behaviour with the following settings. Example to exclude all metadata node types from usage count: ``` Flowpack: Neos: AssetUsage: excludedNodeTypes: - 'Neos.MetaData:AbstractMetaData' ``` Example to exclude multiple custom metadata node types: ``` Flowpack: Neos: AssetUsage: excludedNodeTypes: - 'Vendor.PackageName:Custom.MetaData.NodeType1' - 'Vendor.PackageName:Custom.MetaData.NodeType2' ``` Related packages ---------------- [](#related-packages) - [Flowpack.EntityUsage](https://github.com/Flowpack/Flowpack.EntityUsage) the generic usage implementation - [Flowpack.EntityUsage.DatabaseStorage](https://github.com/Flowpack/Flowpack.EntityUsage.DatabaseStorage) for storing usages in the database Development goal ---------------- [](#development-goal) This functionality will at some point be integrated into the core of a future Neos CMS version. ### Health Score 38 — LowBetter than 85% of packages Maintenance45 Moderate activity, may be stable Popularity33 Limited adoption so far Community21 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~218 days Recently: every ~255 days Total 7 Last Release 398d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/25d49a6af82b72d2764774a05c307808375016d7aeaaef3862472a6580ff38a7?d=identicon)[flowpack](/maintainers/flowpack) --- Top Contributors [![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (10 commits)")[![andrehoffmann30](https://avatars.githubusercontent.com/u/23524251?v=4)](https://github.com/andrehoffmann30 "andrehoffmann30 (3 commits)")[![jonnitto](https://avatars.githubusercontent.com/u/4510166?v=4)](https://github.com/jonnitto "jonnitto (3 commits)")[![ahaeslich](https://avatars.githubusercontent.com/u/1756367?v=4)](https://github.com/ahaeslich "ahaeslich (2 commits)")[![daniellienert](https://avatars.githubusercontent.com/u/642226?v=4)](https://github.com/daniellienert "daniellienert (2 commits)")[![crydotsnake](https://avatars.githubusercontent.com/u/39345336?v=4)](https://github.com/crydotsnake "crydotsnake (1 commits)")[![skurfuerst](https://avatars.githubusercontent.com/u/190777?v=4)](https://github.com/skurfuerst "skurfuerst (1 commits)")[![theDex](https://avatars.githubusercontent.com/u/3844381?v=4)](https://github.com/theDex "theDex (1 commits)") --- Tags neoscms ### Embed Badge ![Health badge](/badges/flowpack-neos-asset-usage/health.svg) ``` [![Health](https://phpackages.com/badges/flowpack-neos-asset-usage/health.svg)](https://phpackages.com/packages/flowpack-neos-asset-usage) ``` ### Alternatives [sitegeist/monocle An living-styleguide for Neos that is based on the actual fusion-code 45315.9k10](/packages/sitegeist-monocle)[sitegeist/kaleidoscope Responsive-images for Neos 29352.4k10](/packages/sitegeist-kaleidoscope)[flowpack/listable Tiny extension for listing things 35209.0k7](/packages/flowpack-listable)[kaufmanndigital/gdpr-cookieconsent A ready-to-run package, that integrates an advanced cookie consent banner into your Neos CMS site. 2540.7k](/packages/kaufmanndigital-gdpr-cookieconsent)[neos/seo SEO configuration and tools for Neos 13990.5k24](/packages/neos-seo)[shel/neos-colorpicker A plugin for Neos CMS which provides a colorpicker editor 1494.4k6](/packages/shel-neos-colorpicker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)