# CombinedListing

A combined listing that groups multiple products under shared options.

## Type Definition

```graphql
type CombinedListing {
  options: [String]
  optionsWithValues: [ProductOption]
  optionsByHandle: [ProductOption]
}
```

## Fields

| Field | Type | Description |
|-------|------|-------------|
| options | [String] | Returns the options handles. |
| optionsWithValues | [ProductOption] | Returns array of options. |
| optionsByHandle | [ProductOption] | Returns array of options indexed by handle. |

## Relationships

CombinedListing is used to group multiple products under shared options. It contains references to ProductOption objects that define the available options for the combined listing. This type is primarily used within the Product type's combinedListing field to provide structured option data.

## Example

```graphql
{
  options
  optionsWithValues {
    name
    values
  }
  optionsByHandle {
    name
    values
  }
}
```

## Implements

This type does not implement any interfaces.

## Related Types

- [ProductOption](/reference/storefront/1.3.0/objects/product-option)
- String