> For the complete documentation index, see [llms.txt](https://help.upscorecard.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.upscorecard.org/using-the-tool/choose-your-mode.md).

# Choose your mode

The UP Scorecard offers two different scoring pathways: [**product comparison mode**](https://help.upscorecard.org/using-the-tool/choose-your-mode/product-comparison.md) and [**portfolio scoring mode**](https://help.upscorecard.org/using-the-tool/choose-your-mode/portfolio-scoring.md).&#x20;

## Product comparison mode

Product comparison mode compares products that provide the same service. For example, you can compare different types of beverage containers:

<figure><img src="https://2166615972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaICx0ac7YkEop45tsD3R%2Fuploads%2FGfalLmGeoWaaLNLj9yiz%2Fproduct%20comparison.png?alt=media&amp;token=cacb5d06-6bba-4f18-a3ee-f3504f40d4b9" alt=""><figcaption></figcaption></figure>

The scores for [*Climate*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/climate-impact.md), [*Water*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/water-use.md), and [*Plastic Pollution*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/plastic-pollution.md) are calculated for a [standard service amount](https://help.upscorecard.org/misc/glossary.md#functional-unit) (e.g. 1 liter of beverage served). The qualitative metrics ([*Chemicals of Concern*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/chemicals-of-concern.md), [*Recoverability*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/recoverability.md), and [*Sustainable Sourcing*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/sustainable-sourcing.md)) are based on the material values set by default or on customized properties set by the user.

***

## Portfolio mode

In portfolio scoring mode, you can assess an entire product portfolio:

<figure><img src="https://i.imgur.com/Nil5E90.png" alt=""><figcaption></figcaption></figure>

The scores for [*Climate*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/climate-impact.md), [*Water Use*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/water-use.md), and [*Plastic Pollution*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/plastic-pollution.md) are calculated for all products in the portfolio (e.g. 10 x 250ml cups). The qualitative metrics ([*Chemicals of Concern*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/chemicals-of-concern.md), [*Recoverability*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/recoverability.md), and [*Sustainable Sourcing*](https://help.upscorecard.org/methodology/the-six-up-scorecard-metrics/sustainable-sourcing.md)) are based on the material values set by default or on customized properties set by the user.

You can compare this portfolio to the Best and Worst portfolios (automatically generated by the UP Scorecard).

The Best and Worst portfolios always provide the same service and serve the same foods (or beverages) as your portfolio. But they only include the best-scoring (conversely the worse-scoring) products.

On the other hand, the UP Scorecard allows you to add and compare any other portfolio you have created, regardless of the types of services they provide. This comparison is likely to be most useful when the two portfolios provide the same use cases and number of uses.

<table data-view="cards"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Product Comparison mode</td><td></td><td></td><td><a href="https://2166615972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaICx0ac7YkEop45tsD3R%2Fuploads%2FmC1Qq7Aq59qaXSb6zbzn%2FComparing%20products.png?alt=media&amp;token=b117428d-03d8-46b9-bd9d-43a11c114e1e">Comparing products.png</a></td><td><a href="https://help.upscorecard.org/using-the-tool/choose-your-mode/product-comparison.md">Product Comparison</a></td></tr><tr><td>Portfolio Scoring mode</td><td></td><td></td><td><a href="https://2166615972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaICx0ac7YkEop45tsD3R%2Fuploads%2FFDHOICSReUNnyMLY7Bcv%2FScoring%20a%20portfolio.png?alt=media&amp;token=101c66c6-ecb8-49d0-b25f-7c6e1802b550">Scoring a portfolio.png</a></td><td><a href="https://help.upscorecard.org/using-the-tool/choose-your-mode/portfolio-scoring.md">Portfolio Scoring</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.upscorecard.org/using-the-tool/choose-your-mode.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
