# Read the Portfolio

The Portfolio answers two questions: does anything need you, and how is the whole of what you run doing? It has six tabs: **Overview**, **Health**, **Usage**, **Costs**, **Revenue** and **Obligations**. This guide covers the tabs' shared frame and the **Overview**. The others have their own guides: [the project dashboard](project-dashboard.md) for **Health** and **Usage**, which read the same way across projects, [Costs and budgets](costs-and-budgets.md), [Revenue and profit](revenue-and-profit.md) and [Expiries and the calendar](expiries-and-calendar.md).

What you see depends on your access:

- **Owner** and **Admin**: every project and every tab, and the next step when something isn't connected.
- **Editor** and **Viewer**: the projects shared with you. The line under the workspace's name says so ("1 of 2 projects"); the others are counted, never named.
- Without **Can see amounts (revenue, costs, profit)**: see [Without amounts](#without-amounts).

## Open it

In the sidebar, choose **Portfolio** (on a phone, **Portfolio** in the bar at the bottom). Or press `g` then `p`.

The tabs are under the workspace's name. On a computer `1` to `6` move between them. Their numbers stay out of sight until you ask: hold `⌘` (`Ctrl` on Windows and Linux) for a moment and each tab shows its number, as every control on the page shows its key. On a phone the row scrolls sideways.

## The view bar

The row under the tabs sets what everything below it shows. A project's tabs have the same bar.

1. Press the period (it starts at **30 days**, or `p`) and choose **7 days**, **30 days**, **90 days**, **12 months**, **Month to date**, **Quarter to date** or **Year to date**.
2. Or choose **Custom range…**. Press a first day and a last day in the calendar, use **Earlier month** and **Later month** to move, and press **Apply** (or **Cancel**). The dialog says where days begin and end: "Days run midnight to midnight, Europe/Sofia."
3. Press the comparison ("vs previous 30 days") and choose **Previous period**, **Same period last year** or **None**. `⇧C` turns it on or off.
4. Where the figures come in more than one currency, a third button lists them. On a project in another currency than the workspace's, it offers the project's and "Show in USD".

On a phone these fold into one button, "30 days · vs previous". It opens **View**, with **Period**, **Comparison** and **Currency** as lists. A pull down from the top of the page reads the figures again.

Your period and comparison are saved for you, and the page opens with them next time. They also go in the page's address, so a link shows someone the same view. A currency chosen on a project stays in that address only.

Days and months follow your workspace's **Time zone**. When its **Fiscal year starts in** another month than January, **Year to date** reads "FY 2027 to date". Both are in **Settings → General**.

At the end of the bar, a line says how fresh the figures are: "Updated 03:39 AM · Costs complete through Nov 3". The date appears only when a source is behind. Press the line for **Sources**, each with how far it's complete ("Stripe · through Nov 4") and the connection's own name after the service's when it has one ("Stripe · Nanner Tech LLC · through Nov 4"). A source in trouble says so. For an admin, a connection that is stale or failing has **Sync now** there, and one that needs signing in again has **Reconnect**. While a change takes a moment, the line says "Updating…".

When your plan keeps less history than the period you chose, the bar says so: "History starts Oct 8 · Free keeps 30 days".

## Needs you

**Needs you · 10** comes first on the **Overview**: the things to deal with, the most urgent first, with **Critical**, **Warning** or **For review** as an icon. Five show; **Show 5 more** opens the rest. Each row names the project, says what happened and how long ago, and has one action:

| Action                                     | Takes you to                                                                                                                        |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Open incident**                          | The incident on [Alerts](alerts.md)                                                                                                 |
| **Reconnect**                              | The connection, on Connections' **Connected** tab                                                                                   |
| **Mark renewed**                           | Stays here: the expiry moves to its next date, and the page says "… is renewed." with **Undo**                                      |
| **Open provider**                          | The project's **Obligations** tab. A one-time obligation has this and no **Mark renewed**: it has no next date, so change it there. |
| **See costs**, **See runs**, **See usage** | The tab with the figures behind it                                                                                                  |
| **Review**                                 | The binding review                                                                                                                  |

To put a row aside for yourself:

1. Press **Snooze**. With the keyboard, tab to a button in the row and press `s`.
2. Choose **1 day**, **1 week** or **Until it changes**.
3. The row goes and the page says "Snoozed." with **Undo** for 10 seconds.

A snooze is yours alone. Everyone else still sees the row.

With nothing to do, the section says "Nothing needs you." and why that's so: "2 of 2 surfaces up · nothing expires in 30 days · spend within budgets".

## The statement

Under **Needs you**, five cards: **Net profit · 30 days**, **MRR**, **Costs · 30 days**, **Fleet health** and **Next expiry**. **Net profit** is the page's one gold figure, or red with a minus sign and an icon when it's a loss.

Each card shows the figure, its change against the comparison ("25.2% vs previous 30 days", with an arrow) and a line saying what it covers and where it comes from. **Costs** has a bar for how much of the budget for those days is spent ("189% of the budget for this period"); **Month to date** reads the month's whole budget ("58% of this month's budgets"). **Next expiry** names the nearest date and the next ones after it.

### What a figure tells you

A figure never hides what it leaves out. Look for these on a card:

| You see                                                                                                         | It means                                                                                                                        |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| "—"                                                                                                             | Nothing is known, or the amount is hidden from you. It never stands for 0.                                                      |
| "3 of 3 projects"                                                                                               | Every project you see is counted.                                                                                               |
| A copper dot and "Costs from 8 of 12 projects"                                                                  | Some projects have no source yet. The figure counts only the others.                                                            |
| "so far" and "Complete through Nov 3 · later days so far"                                                                     | The period isn't over. Every source is complete through Nov 3, and later days count what has arrived so far.                                                             |
| A clock and "Stale since 09:14 · Stripe needs you to sign in again"                                             | The source stopped reporting. The figure is the last known one, muted. Owners and admins get **Reconnect**.                     |
| **EST** and "Includes $310 estimated (EST)"                                                                     | A fifth or more of the figure is estimated rather than billed.                                                                  |
| "EUR amounts not converted: no rate."                                                                           | The amounts in that currency are left out until a rate is in.                                                                   |
| "Backfilling older history · through 2025-03"                                                                   | Older months are still loading.                                                                                                 |
| "First full period ends Nov 24"                                                                                 | A source is too new for a full period, so a change isn't meant yet.                                                             |
| "3 of 3 projects · plus revenue not yet split by project", or "Across the workspace · not yet split by project" | Revenue no project takes yet is counted. Owners and admins get **Review bindings** (see [Review bindings](review-bindings.md)). |

An empty card says what would fill it. Owners and admins get the step: a link such as "Connect Stripe to see MRR.", "Watch a domain to see uptime and renewals." or, when a connection brings it in with nothing bound yet, "A connection brings this in, but nothing of it is bound to a project yet." with **Review bindings**. **Net profit** without costs says "Connect costs to see profit". Editors and viewers get **Ask Ana** (see [Ask an admin](projects.md#ask-an-admin)).

### Explain a figure

Every card is a button. Press it, or tab to it and press `e`, to see how the figure was made. A sheet opens at the side (the whole screen on a phone), titled with the figure: "MRR · $132.50", or "MRR · ≈ $132.50" when it includes a conversion. The card shows the figure without the "≈"; the sheet lists the rates.

- **What it is**: the figure in a sentence.
- **How it was computed**: the sum with its numbers, such as "Net revenue $400.00 − variable costs $204.00 − allocated fixed costs $259.14 = −$63.14."
- **What it's made of**: the parts, usually one row per project. **Unallocated** and **Not yet split** have their own rows, and for owners and admins **Not yet split** links to the binding review.
- **Coverage and freshness**: each source and how far it's complete, and each project with no source ("Beacon has no costs source.") with what would fill it.
- **Conversions**: the exchange rates used, or which currencies have none.
- **See the rows →**: opens the tab with the rows behind the figure. A card worked out from others, such as **Month-end forecast**, **ARR** or **Revenue churn**, has none.

`Esc` closes the sheet. **Explain MRR** in the command palette (`⌘K` / `Ctrl K`) opens MRR's from anywhere.

## Read a chart

The Overview has **Revenue and costs** beside the **Expiry radar · 90 days**. Every chart in ShipVitals works the same way.

- A sentence above it says what it shows, such as "Revenue fell 100% to $0.00 from Oct 24 to Nov 3."
- Hover for the figures of a day. With the keyboard, tab to the chart, then `←` `→` move day by day, `Home` and `End` jump, `Enter` opens what a mark leads to and `Esc` lets go. On **Revenue and costs** and **MRR**, pressing a day (or `Enter`) narrows the page to it, and Back returns.
- On a phone, tap a day to read it, and drag sideways to move along the chart.
- **Show as table** under the chart lists the same figures as text. `t` does the same on a focused chart.
- A dashed end means the last day isn't over yet.
- The lane under a chart marks events: deploys, connections added, price changes. Each mark can be hovered, focused or tapped. **Show events** turns it off for you on the charts that have it.
- **Add a note** beside a chart's heading puts a dated note on the lane, such as "Launched on HN", or `n` on a focused day. It is for those who manage alerts. Press a note's mark to open its day, with **Remove**.
- When your plan keeps less history than the period, the lane marks where it starts: "History starts Oct 4 · Free keeps 30 days".

**Patterns in charts** and **Compact tables (32 px)** are in [Account settings](account-settings.md) under **Preferences**.

## The projects table

**Projects** ends the Overview: each project's **Health**, **Users**, **MRR**, **Costs**, **Net** and **Next expiry**, your pinned ones first, then those that need you. A row of a project with a budget has a small bar beside its **Costs**: how much of this month's budget it has spent ("60% of this month's budget"), whatever period the **Costs** figure covers. An open-source or public-good project shows "Cost to run $21.11" under **Net**.

- Press a row, or its name, to open the project (see [The project dashboard](project-dashboard.md)).
- Press a column's heading to sort by it, again to reverse it. Your sort is saved.
- Type in **Filter projects** (or press `/`).
- **Needs attention**, **Commercial** and **OSS & public good** narrow the list. **Group by kind** groups it.
- Press the star beside a name to pin it. With the keyboard, `j` `k` move between rows and `⇧P` pins the one you're on.
- **Table actions → Export CSV** saves the table as you see it.

When the table is wider than the page, as on a tablet, it says "Scroll the table sideways for more columns." and the project names stay in place while it scrolls.

**Total · 3 projects** closes the table, and its Net is the **Net profit** card. Above it, **Not yet split** is revenue no project takes yet, **Unallocated** is costs no project takes, and **Other net revenue** is the revenue of projects whose Net doesn't show it (a "Cost to run" project, or one with no costs yet). While you filter, the total adds up the rows you can see.

On a phone each project is a card, the same lines close the list under **Totals**, and **Sort and filter** opens the filter, the chips and a button for each column to sort by. **Table actions** is beside it.

With nothing left after a filter, it says "No project matches." Owners and admins also see "2 proposed projects waiting for review", which opens the binding review.

## Since your last visit

Come back after more than an hour and a line under the workspace's name says what changed: "Since Tuesday, 09:14 · MRR +$120 · 1 new incident · 3 deploys". Press its first part to see those incidents on [Alerts](alerts.md). With nothing new, there is no line.

## Nothing connected yet

Before anything feeds the Portfolio it says "No services connected yet."

- Owners and admins get the next step in gold, and **Explore a sample portfolio** under it.
- Editors and viewers read who is setting up: "Ana (admin) is setting up connections. You'll see your projects here when they're in."

To look around first:

1. Press **Explore a sample portfolio**. Every tab opens with made-up figures for "Sample studio".
2. The banner says "Sample data · nothing here is yours" on every tab. Move between the tabs as usual.
3. Press **Back to your portfolio** to leave.

The sample shows one fixed view, so the view bar is a line of text. Nothing you do there changes your workspace, and nothing there reads your data.

## Without amounts

Without **Can see amounts (revenue, costs, profit)** on your projects, the tabs are **Overview**, **Health**, **Usage** and **Obligations**. The statement is **Fleet health**, **Active users**, **Next expiry** and **Open incidents**, and **MRR**, **Costs** and **Net** in the projects table show "—". With amounts on some projects only, the figures count those, and the chart says "Only the projects whose amounts you can see."

When no project is shared with you any more, the page says "No projects are shared with you in … any more." with **Leave workspace**.

## The weekly self-check

Where this check is switched on, the owner may see a question at the end of the tab once a week: "Did you open a provider console for a daily check this week? Which one?" Press **No**, or **Yes** and then the service. It blocks nothing, and it goes once you've answered. If the answer doesn't save, it says "Couldn't save your answer. Try again."

## Keyboard

| Key                    | Does                                      |
| ---------------------- | ----------------------------------------- |
| `1` to `6`             | Go to a tab                               |
| `p`                    | Open the period menu                      |
| `⇧C`                   | Turn the comparison on or off             |
| `e`                    | Explain the focused card                  |
| `s`                    | Snooze the focused row of **Needs you**   |
| `/`                    | Filter projects                           |
| `j` `k`                | Move between projects                     |
| `⇧P`                   | Pin the focused project                   |
| `←` `→`, `Home`, `End` | Move along the focused chart              |
| `t`                    | Show the focused chart as a table         |
| `n`                    | Add a note on the focused day, if you can |

`?` lists every key. Single keys follow **Single-key shortcuts** in [Account settings](account-settings.md).

## When it doesn't work

| The page says                   | What to do                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------- |
| "That didn't start. Try again." | **Sync now** didn't reach the connection. Try again, or open it in [Connections](connection-health.md). |
| "That didn't save. Try again."  | A snooze or a pin wasn't saved. Check your connection and try again.                                    |
| "The rest didn't load."         | Press **Try again**. The table keeps what it has.                                                       |
| **Page not found**              | You don't have that tab, or the page's address is wrong.                                                |
