Extras catalogue

mediaFal

Latest release 1 hour ago (November 10, 2026).

mediafal

  • By theuros

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

Releases 1 indexed release

Changelog
MODX.com

1.0.0-beta2

November 10, 2026

1 hour ago

<p>Initial release.</p>