# The Portfolio screen

The **Portfolio** screen is a single view of every loan in your organization's reconciled portfolio. Vintage builds the portfolio from the uploads you accept; this screen shows the result: one row per loan, a band of summary figures above the rows, and the **Segment Builder** beside them for narrowing the book down. Open it from **Portfolio** in the main navigation. Every member of the organization can open it, viewers included.

Today the screen is deliberately plain: a window into what Vintage made of your uploads, loan by loan. The analysis itself happens on the [Modeling screen](/modeling/the-modeling-screen/).

**Note:** While the Vintage team is setting up a new organization's first portfolio, the Portfolio entry is not in the navigation, and going to the screen directly shows a page explaining that the portfolio is being set up. It opens for everyone once setup is done. See [Your first upload](/uploading/your-first-upload/).

## The summary band

Six figures sit across the top of the screen. They describe the **whole portfolio**, not the segment you have built.

| Figure | What it counts |
|---|---|
| **Total Loans** | Every loan in the portfolio. |
| **Snapshots** | Every snapshot observation: one loan reported in one snapshot month counts once. |
| **Transactions** | Every transaction recorded against the portfolio's loans. |
| **Credit-Loss Ready** | Loans that have what the credit-loss measure needs. |
| **Payoff Ready** | Loans that have what payoff detection needs. |
| **Prepayment Ready** | Loans that have what the partial-prepayment measure needs. |

### The three readiness figures

A loan is **ready** for an output when it carries that output's base fields itself and the event the output measures is reported somewhere in your data. A performing loan with no charge-off record is therefore ready for credit loss: it contributes exposure (dollars at risk) to the loss curve, and the absence of a charge-off is a measured zero rather than missing data. One exception holds: a charge-off reported only as a flag or status, with no amount anywhere, makes no loan ready for credit loss. The full rule is on [Reviewing before you finalize](/uploading/reviewing-before-you-finalize/).

Each readiness figure shows the count of ready loans and, beneath it, the share of the whole portfolio:

$$
\text{ready share} = \frac{\text{loans ready for the output}}{\text{total loans in the portfolio}}
$$

rounded to a whole percent and written with its denominator, for example "79% of 5,000 loans". In words: of every loan in the book, this is the fraction the output can be modeled for.

### What the book says about each event

Readiness says a loan *can* be measured. It does not say the event happened. So under each readiness figure is a line saying what your data actually reports about that event. It is always one of three statements, the same three the Review step makes:

- **Counted.** When one of your columns proves the event loan by loan (a non-zero charge-off, payoff, or prepayment amount, or an event date), the line gives how many loans recorded it: "1,204 recorded a charge-off".
- **Carried another way.** When no such column exists but your data still carries the event, the line names the source instead of a count: "Payoffs from your Loan Status values", "Prepayments from actual vs scheduled principal". It names the same source the Review card names.
- **Not in the data.** When nothing in the book carries the event, the line says so: "No charge-off data yet".

If the count has not been taken for every loan yet, the line says the recorded-event count is still being updated rather than reporting a number it has not finished.

### "Counting…" instead of a zero

The band never prints a zero it has not counted. While an accepted upload is still being read into loans, a figure that would read zero shows **Counting…** instead. One upload can hold a very large number of loans, so at that moment the count is unknown, not zero.

## The loan table

The table has one row per loan. Loans load a page at a time as you scroll, and searching, filtering by segment, and sorting all apply to the whole portfolio, not only to the rows already loaded. Changing the search, the segment, or the sort keeps your scroll position and your current rows on screen while the new results arrive.

| Column | What it shows |
|---|---|
| **Loan** | The loan's **protected ID**, the one-way scrambled replacement for your Loan ID. A long ID is shortened in the cell; hover it for the whole value. A **Tax ID on file** marker appears when the loan also has a protected Tax ID. |
| **Original Amount** | The Original Loan Amount you uploaded. |
| **Origination** | The origination date, exactly as your file wrote it. |
| **FICO** | The FICO score. |
| **Rate** | The interest rate as a plain number in percent points: `5.25` means 5.25%. |
| **Current Balance** | The balance from the loan's most recent snapshot. |
| **Original Balance** | The original balance Vintage models with, marked **Provided** or **Est. (first balance)**. |
| **Status** | How the loan's life on the book ended, or that no ending was reported. See below. |
| **Term** | The term in months, marked **Provided**, **Derived** (from a Maturity Date), or **None**. |
| **Age** | The loan's age in months at its most recent reported month. |
| **Modelable** | **Yes** when the loan has at least one snapshot month that reports a balance, can be aged, and has a term: the three things a loan needs to enter the curves. |
| **Snapshots** | How many snapshot months the loan appears in, with the most recent one beneath. |
| **Transactions** | How many transactions the loan has. |
| **Readiness** | Three dots, in the order credit loss, payoff, prepayment. A filled dot means ready. |

A value that is missing, or present but not readable as a number, shows as a dimmed dash.

When no Original Loan Amount was uploaded for a loan, its original balance is the first balance Vintage saw for it, marked **Est. (first balance)**. A derived term is the number of calendar months from origination to the Maturity Date you supplied. [Origination and term](/concepts/origination-and-term/) explains both, and why a loan with neither a term nor a maturity date stays out of the curves.

### The Status column

The **Status** column is Vintage's own resolved answer about how each loan ended. It is not one of your status words passed through. Every loan has at most one ending, decided once from everything your data says, and the curves, this column, and the disclosures all read that same answer. [How a loan's ending is decided](/concepts/how-a-loan-ends/) gives the rules.

The column reads one of four things:

| Status | Meaning |
|---|---|
| **Paid off** | The loan's ending is a payoff. |
| **Charged off** | The loan's ending is a charge-off. |
| **Exited (other)** | The loan left the book for a reason that is neither a payoff nor a default: sold, participated out, or transferred. |
| **Open** | Your data proves no ending at all. A faint note beneath reads **No exit reported**. |

The "No exit reported" note is the point of the Open reading. Three quite different situations all land on "no ending": a loan that stopped reporting while it still owed money, a zero-balance loan past its term that nobody marked closed, and a loan paid off partway through its history whose later rows carry no marker. So the cell states the reason it reads open rather than claiming the loan is alive. (The classification menu's "Open (still active)" is deliberately not reused here. There, you are declaring what one of your own status words means. Here, Vintage is reporting what it resolved, and it will not claim a loan is alive when it cannot prove it.)

**Closed before data begins.** A loan whose ending is already on the very first row Vintage ever sees for it **arrived already closed**. It is not Open, because your data states its ending, so the cell shows that ending (**Charged off**, **Paid off**, or **Exited (other)**) with the faint note **Closed before data begins** beneath. The note is the reason the loan is not in the curves: its ending is real, but Vintage never saw it open, so there is no age at which to place the ending. A loan can also become one of these later, if you reclassify one of your status values on the [Fields screen](/portfolio/fields/); once the portfolio has been updated, the column shows it.

### Transactions are a count, with no dollar figure

The Transactions column shows how many transactions a loan has and nothing more. A loan's transactions are different kinds of event (charge-offs, recoveries, payoffs, partial prepayments), and adding them into one total would produce a number that matches nothing in your own ledger and hides the very distinction that matters: a loan that recovered most of its charge-off would read the same as one that recovered nothing. This does not affect any modeled number. The credit-loss and prepayment measures read each transaction's amounts by kind.

### Searching for a loan

The search box above the table searches by **protected ID**. Because Vintage scrambles your Loan IDs in your browser before anything is uploaded, it never holds your real loan numbers, so a core-system loan number cannot be found here. Search for the protected ID shown in the table instead. The search ignores capitalization and matches any part of the ID. [Removing personal information](/uploading/removing-personal-information/) explains protected IDs.

The screen only ever shows protected identifiers, never a raw loan number or Tax ID, and never shows loans from another organization.

### Sorting the whole portfolio by a column

Click the header of **Loan**, **Original Amount**, **FICO**, **Rate**, **Current Balance**, **Snapshots**, or **Transactions** to sort the whole portfolio by that column. One column is sorted at a time.

A link to the Portfolio screen carries your search and your sort. It does not carry your segment: a colleague who opens the link sees their own segment applied.

## Slicing the portfolio with a segment

The **Segment Builder** panel beside the table narrows the portfolio to the loans you care about: loans originated in a date range, with a balance over a figure, with a FICO score in a band, and so on. The loan table and the panel's live count both read the one segment, so they always agree, and the same segment drives the Modeling screen. [Segments](/portfolio/segments/) covers every control.

When nothing matches your search and segment, the table says **No loans match your filters** and offers **Clear**. Clear resets the search, the sort, and the whole segment.

## While your portfolio is updating

Accepting an upload, deleting accepted data, retyping a field, or changing how your values are read all cause Vintage to rebuild the affected loans. The Portfolio screen does not show partial numbers while that happens.

**Arriving while the portfolio is updating.** In place of the summary band and the table, the screen shows a processing state. It unlocks on its own the moment the portfolio is current. It says what is happening and why: new loans being added, existing loans being rebuilt, a change to your value vocabulary, or Vintage improving its own model for every loan. It shows only what Vintage has actually measured:

- **N of M loans processed**, with a progress bar, once the total is fixed, and an estimated time remaining once a rate can be measured. When the measurements disagree the estimate widens to a range, and when they never settle it says only "This can take a while.", rather than inventing precision.
- A count of loans processed so far, or a note that your upload is still being read into the portfolio, with **no** bar, while the total is still growing (a first backfill of historical months, or accepted files whose loans have not all been counted). A bar whose denominator grows would appear to go backwards.
- On a very large upload, no loan figure at all: the screen says a large portfolio is being processed and that loan counts will appear once the total is known.
- **Finishing up**, when every loan is processed and only the ranges and value lists the Segment Builder's filters use are still being measured.

When an email is genuinely on its way to you, the screen says you can leave and will be emailed when the portfolio is ready. Otherwise it promises only that the view will unlock by itself. For a typical upload this finishes before you reach the screen; a very large backfill can keep it up for a while. The Review you saw before accepting the upload was complete at the time; this wait is only the Portfolio screen catching up afterward.

**Already reading the list when something changes.** If the portfolio changes while you are on the screen (a colleague accepted an upload, say), Vintage does not tear the list down. The loans already on screen stay, your place is kept, and a notice reads **Your portfolio changed**: the list is from your last complete view, and **Refresh** loads the updated portfolio. If the portfolio is still updating when you press Refresh, you land on the processing state.

**From any other screen.** While the portfolio is updating, the top bar on every screen carries one quiet line saying so, linking here. It reads "Processing your portfolio", adds an "N of M loans" count once every accepted file has been read into loans (before then the loan counters describe the previous portfolio, so no count is quoted), and reads "Finishing up your portfolio" when only the filter statistics remain. The line is hidden on the narrowest phone screens; the Portfolio and Modeling screens still explain the wait in full at every width.

**Caution:** Rarely, a processing failure on Vintage's side leaves some loans that cannot be rebuilt after repeated attempts. Rather than wait forever, the screen serves the rest of the book and states how many loans are temporarily excluded while the issue is investigated. Those loans are left out of every figure, never half-counted, and are expected to return once the issue is resolved. This is a processing statement, separate from the permanent business exclusions such as a loan with no term.

## A portfolio with no loans yet

Before any upload has been accepted, the screen reads **No portfolio yet**. Admins and editors also see **Upload loan data**, which starts a new upload; viewers, who cannot upload, see the message alone. [How uploading works](/uploading/how-uploading-works/) walks through it.

## Related

- [Segments](/portfolio/segments/)
- [Fields](/portfolio/fields/)
- [How a loan's ending is decided](/concepts/how-a-loan-ends/)
- [Reviewing before you finalize](/uploading/reviewing-before-you-finalize/)
- [Finalizing and what happens next](/uploading/finalizing-and-what-happens-next/)
- [The Modeling screen](/modeling/the-modeling-screen/)