Jump to main content Jump to doc navigation

Display images with hyperlinks at designated positions in a page. Fork from Jeroen Kenters BannerX (it was removed from MODX repository by author).


[[BannerY? &position=`1` &sortby=`RAND()` &limit=`1`]]

This will retrieve randomly one banner that is set to be active for assigned position 1.

Available Properties

Name Description Default
tpl Name of a chunk serving as a recourse template byAd
sortdir Order of the results ASC
sortby Return results in random order RAND()
limit If set to non-zero, will only show X number of items 5
position If set to non-zero, will retrieve only images that are assigned to the position given. 0

Available Placeholders

Name Description
idx The index of banner in this position
image The image assigned to this banner
name The name assigned to this banner
url The url assigned to this banner
description Any text message for this banner

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
  • deJaya
  • Digital Penguin
  • Following Sea
  • YJ
  • Sepia River Studios
  • Dannevang Digital
  • eydolan
  • Nick Clark
  • Lefthandmedia
  • Murray Wood
  • Richard


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

Learn more