Jump to main content Jump to doc navigation


Adds an object or collection of objects related to this class.


API Docs: xPDOObject::addMany()

boolean addMany (
   mixed &$obj,
   [string $alias = '']


Add golf clubs to a bag and save.

$bag = $xpdo->newObject('GolfBag');
$bag->set('name',"Chris's Bag");
$clubs = array();
for ($i=1;$i<10;$i++) {
   $club = $xpdo->newObject('GolfClub');
   $club->set('name',$i.' Iron');
   $clubs[] = $club;
$bag->save(); // saves both the bag and all the clubs

Nested Calls You can nest one addMany() call inside another and thus create all your related data via a single save() operation.


Remember that this operation is intended to be called only for objects whose relationships are defined as cardinality="many".

See Also

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
  • modmore
  • Jens Wittmann – Gestaltung & Entwicklung
  • Raffy
  • eydolan
  • Digital Penguin
  • Fabian Christen
  • Dannevang Digital
  • deJaya
  • Following Sea
  • Sepia River Studios
  • Anton Tarasov
  • Lefthandmedia
  • Nick Clark
  • Chris Fickling
  • Murray Wood
  • YJ
  • CrewMark
  • Richard


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

Learn more