> 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/portfolio-scoring.md).

# Portfolio Scoring

{% stepper %}
{% step %}

### Starting a new portfolio

Navigate to *Create or Edit Comparisons between Product Portfolios* and press *Define New Portfolio.* Give your portfolio a name and a description to continue.
{% endstep %}

{% step %}

### Select a region

Currently, users can choose between *Global*, *Europe*, *United States*, *Spain*, and the imaginary [*Ecoville*](/misc/glossary.md#ecoville). This represents the region where the products will be used. More regions might be added in the future.

{% hint style="info" %}
The scoring results for the same products may vary based on the selected regions. This is due to different recycling standards used in different geographical locations. The UP Scorecard assumes average recycling and composting rates of the selected region unless the user specifies which materials can be composted or recycled locally. To customize and use local recovery settings, switch the toggle to *Customize Composting and Recycling* later on in the *Results* screen. 

Learn how to customize recovery settings [here](/using-the-tool/customization/how-to-customize/adjusting-recovery-settings.md).
{% endhint %}
{% endstep %}

{% step %}

### Choose a *use case*

{% endstep %}

{% step %}

### Choose food or beverage content

{% hint style="info" %}
If you want to know why it is important to input what foodstuff or beverage is being served or packed, please read the section on [Food and Material Interaction](/methodology/the-six-up-scorecard-metrics/chemicals-of-concern.md#more-details).

Skipping this step will automatically assume the highest-risk food (Hot, oily, acidic).
{% endhint %}
{% endstep %}

{% step %}

### Choose products

Select at least two products. One of them must be a reusable option. Press *Create Portfolio* to continue. If you are logged in, you also have the option to [create a new product](/using-the-tool/customization/how-to-customize/create-a-new-product.md) to add to the comparison in this step. 

{% hint style="info" %}
In the *Portfolio Scoring* mode, scores will be calculated for the amount of items, not for the volume a product carries.
{% endhint %}
{% endstep %}

{% step %}

### Manage portfolio

From here on you will be able to add new products to your portfolio, edit details of your products, [customize recoverability settings](/using-the-tool/customization/how-to-customize/adjusting-recovery-settings.md), and view your portfolio's score.
{% endstep %}

{% step %}

### View results

On the results page, you will see a table displaying your portfolio's score, as well as the best and worst alternative portfolio. Below that you will find the cumulative raw scores for your portfolio. Individual values for each product can be seen by switching the toggle to *Score per Use of Product.* Furthermore, we provide you with some circularity details and KPIs on your portfolio, as well as details of your portfolio and individual products.
{% endstep %}
{% endstepper %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.