upload_translit_restrict_chars_pattern
Last updated Aug 15th, 2026 | Page history | Improve this page | Report an issue
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$204 per month—let's make that $500!
Learn moreupload_translit_restrict_chars_pattern¶
Name: File Name Character Restriction Pattern Type: Textfield Default: (See Below) Available In: MODX 3.1.0+
When upload_translit is Yes, Media Manager passes this RegEx into filterPathSegment() as the character-restriction pattern for the uploaded name. That keeps file naming independent of friendly_alias_restrict_chars_pattern.
If this setting is empty, uploads fall back to the Friendly URL restriction settings.
Default (same character class as the factory FURL pattern; no .):
/[\0\x0B\t\n\r\f\a&=+%#<>"~:`@\?\[\]\{\}\|\^\'\\\\]/
Do not add . to this pattern unless you want report.pdf saved as reportpdf. To strip dots from Resource aliases only, put . in friendly_alias_restrict_chars_pattern and leave this upload pattern without it.
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$204 per month—let's make that $500!
Learn more










