In most cases, you specify a multi-value property, such as an array or Collection, using the property element, just as you specify a single-value property. In the following example, the phoneNumbers property stores an array of phone numbers:

<text-properties>
  <property name="city"/>
  <property name="state"/>
  <property name="postalCode"/>
  <property name="phoneNumbers"/>
</text-properties>

Notice that phoneNumbers is specified in the same way as city, state, and postalCode, which are all single-value properties. The XHTML output document will include a separate element for each value in the phoneNumbers array.

If a property is an array or Collection of repository items, you specify it using the item element, and set the is-multi attribute to true. For example, in a product catalog, a product item will typically have a multi-valued childSKUs property whose values are the various SKUs for the product. You might specify the property like this:

<item property-name="childSKUs" is-multi="true">
  <text-properties>
    <property name="displayName"/>
    <property name="description"/>
  </text-properties>
</item>

If you index by product (and product is document-level item), the output document will include the displayName and description value for each of the product’s SKUs.