## ProductCombinedListing

The `product_combined_listing` object describes a combined listing of product options. This object is used to combine multiple products under a single option, allowing you to present different products (such as different colors or styles) as selectable options within one product page. This is useful for creating a seamless shopping experience where customers can switch between related products without leaving the page.

## Usage Example

```liquid
{%- comment -%} Show combined listing options {%- endcomment -%}
<ul>
  {% for option in product_combined_listing.options_with_values %}
    <li>{{ option.title }}:
      <ul>
        {% for value in option.values %}
          <li>{{ value.title }}</li>
        {% endfor %}
      </ul>
    </li>
  {% endfor %}
</ul>
```

## Properties

### options

Returns the options handles.

### options_by_handle

Returns array of [options](/reference/liquid/objects/store/product_option/) indexed by handle.

### options_with_values

Returns array of [options](/reference/liquid/objects/store/product_option/).