Jump to main content Jump to doc navigation

lighten is an Output Modifier that accepts a hex value and percentage (+ or -) option. Additionally, 'max' or 'rev' can be set as an option, with or without a percentage.



Result: lightens the $input hex color by 20%


Result: darkens the $input color by 30%


Result: if the $input value is above the $threshold value, 'ffffff' will be returned, else '000000' will be returned. The $threshold value can be defined in the Snippet properties.


Result: this would output the reverse of the $input hex (white or black) at 60% (so it'd be more of a medium grey in this case)

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.


  • modmore
  • Jens Wittmann – Gestaltung & Entwicklung
  • Fabian Christen
  • Dannevang Digital
  • Digital Penguin
  • Sepia River Studios
  • CrewMark
  • Chris Fickling
  • deJaya
  • Following Sea
  • Anton Tarasov
  • eydolan
  • Raffy
  • Lefthandmedia
  • Murray Wood
  • Snow Creative
  • Nick Clark
  • Helen
  • JT Skaggs
  • krisznet
  • YJ
  • Yanni
  • Richard


$370 per month—let's make that $500!

Learn more