# collection-finder handler

<span class="notranslate">Similar to collection-handler, this handler retrieves the list objects contained on a parent collection.</span>

<div id="bkmrk-attribute-usage-coll"><table class="confluenceTable tablesorter tablesorter-default stickyTableHeaders" role="grid"><thead class="tableFloatingHeaderOriginal"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" aria-label="Attribute: No sort applied, activate to apply an ascending sort" aria-sort="none" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="0" role="columnheader" scope="col" tabindex="0"><div><div>**Attribute**</div></div></th><th aria-disabled="false" aria-label="Usage: No sort applied, activate to apply an ascending sort" aria-sort="none" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col" tabindex="0"><div><div>**Usage**</div></div></th></tr></thead><tbody aria-live="polite" aria-relevant="all"><tr role="row"><td class="confluenceTd">collection

</td><td class="confluenceTd">EL expression that contains the objects collection

</td></tr><tr role="row"><td class="confluenceTd">if

</td><td class="confluenceTd">EL expression that must be evaluated to true prior to handler action

</td></tr><tr role="row"><td class="confluenceTd">unless

</td><td class="confluenceTd">EL expression that must be evaluated to false prior to handler action</td></tr></tbody></table>

</div><span class="notranslate">The following example shows how you could retrieve City objects as a collection of objects within the County object:</span>

```western
<datanode name="country">
        ...
    <finder name="cities" type="city" >
        <collection-finder collection="${instance.cities}">
    </finder>
        ...
</datanode>
```