Extras catalogue
mediaFal
Latest release 1 hour ago (November 10, 2026).
mediafal
About
A file abstraction layer media source for MODX 3. Each file is stored once on a fixed path, editors organise files in virtual folders, so renaming or moving never breaks links. Tracks where every file is used, protects used files from deletion, keeps alt/title per language and adds a media library, resource attachments, a multi-file TV with crop and migration with 301 redirects.
Installation & usage
Requirements: MODX 3.0+, PHP 8.1+, GD or Imagick (Imagick recommended).
Installation
Install through Package Management. On the first install a form offers (all checked by default):
- create a FAL media source Images (
assets/media/images/) and Files (assets/media/files/), - make the Images source the default media source,
- hide
assets/media/in the core Filesystem source (recommended), so nobody uploads past mediaFal.
After installation
- Cron: add a nightly job for the full usage scan and trash clean-up:
php core/components/mediafal/cli/scan.php. Without cron, run Extras > mediaFal: scan usage from time to time. - Media sources: set the media source of your TVs, ContentBlocks fields and rich text editors to a FAL source.
- Existing files: Media > Migration to mediaFal moves them into a FAL source, rewrites the links in content and TVs and adds 301 redirects.
- Attachments: enable the tab per template (template tab Attachment groups).
- Output:
[[falFiles]]lists the attachments of the current resource;[[falFiles? &filter=`images`]]shows images only.
Test on a copy of your site first and keep a backup of the database and the assets/ folder.
Full documentation: https://modx.tend.si/mediafal/
At a glance
MODX 3 compatibility unknown. Based on our testing and community reports where available.
- Developer theuros
- Latest release November 10, 2026 (1 hour ago)
- First seen in SiteDash November 10, 2026 (1 hour ago)
- License GPLv2
- MODX support 3.0 – 100.0
| Changelog | |||
|---|---|---|---|
| MODX.com |
1.0.0-beta2 |
November 10, 2026
1 hour ago |
|
|
<p>Initial release.</p>
|
|||
|
No matching releases. |
|||