> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heychocolate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Comparisons

> Side-by-side sustainability comparisons of products, materials, and scenarios.

The Comparison module enables side-by-side evaluation of products or scenarios on sustainability parameters. Ideal for product detail pages, procurement tools, and decision-support interfaces.

## Comparing products

```graphql theme={null}
query {
  compareProducts(
    productIds: ["prod_abc123", "prod_def456", "prod_ghi789"]
    metrics: [CO2_EQUIVALENT, MKI_SCORE, WATER_FOOTPRINT]
  ) {
    products {
      id
      name
      sectorTag
      scores {
        metric
        value
        unit
        rank
      }
    }
    winner {
      metric
      productId
      productName
    }
    summary {
      bestOverall
      description
    }
  }
}
```

**Response:**

```json theme={null}
{
  "data": {
    "compareProducts": {
      "products": [
        {
          "id": "prod_abc123",
          "name": "Standard Window Frame",
          "sectorTag": "HIGHTECH_MANUFACTURING",
          "scores": [
            { "metric": "CO2_EQUIVALENT", "value": 24.8, "unit": "kg_co2e", "rank": 3 },
            { "metric": "MKI_SCORE", "value": 1.74, "unit": "EUR", "rank": 3 },
            { "metric": "WATER_FOOTPRINT", "value": 320, "unit": "liters", "rank": 2 }
          ]
        },
        {
          "id": "prod_def456",
          "name": "Bio-based Window Frame",
          "sectorTag": "HIGHTECH_MANUFACTURING",
          "scores": [
            { "metric": "CO2_EQUIVALENT", "value": 12.4, "unit": "kg_co2e", "rank": 1 },
            { "metric": "MKI_SCORE", "value": 0.87, "unit": "EUR", "rank": 1 },
            { "metric": "WATER_FOOTPRINT", "value": 280, "unit": "liters", "rank": 1 }
          ]
        }
      ],
      "winner": [
        { "metric": "CO2_EQUIVALENT", "productId": "prod_def456", "productName": "Bio-based Window Frame" },
        { "metric": "MKI_SCORE", "productId": "prod_def456", "productName": "Bio-based Window Frame" }
      ]
    }
  }
}
```

## Comparing scenarios

Compare multiple what-if scenarios against a baseline:

```graphql theme={null}
query {
  compareScenarios(input: {
    baseProductId: "prod_abc123"
    quantity: 100
    scenarios: [
      { name: "Current", overrides: [] },
      { name: "Bio-based", overrides: [{ parameter: MATERIAL, value: "bio_based" }] },
      { name: "Recycled", overrides: [{ parameter: RECYCLED_CONTENT, value: "80" }] }
    ]
    metrics: [CO2_EQUIVALENT, MKI_SCORE]
  }) {
    scenarios {
      name
      scores { metric value unit }
      deltaFromBaseline { metric percentageChange }
    }
  }
}
```

## Available comparison metrics

| Metric              | Description                      | Unit    |
| ------------------- | -------------------------------- | ------- |
| `CO2_EQUIVALENT`    | Total greenhouse gas emissions   | kg CO2e |
| `MKI_SCORE`         | Environmental cost indicator     | EUR     |
| `WATER_FOOTPRINT`   | Total water consumption          | liters  |
| `ENERGY_USE`        | Total energy consumption         | kWh     |
| `RECYCLED_CONTENT`  | Percentage of recycled material  | %       |
| `TRANSPORT_IMPACT`  | Transport-related emissions only | kg CO2e |
| `CIRCULARITY_SCORE` | Product circularity rating       | 0-100   |

## Use cases

* **Product detail pages**: "Compare with similar products" widget
* **MKI marketplace**: Side-by-side comparison like [Insert Marktplaats](https://marktplaats.insert.nl)
* **Procurement**: Evaluate supplier alternatives on sustainability
* **Reporting**: Benchmark products against industry averages