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 for Health and Usage, which read the same way across projects, Costs and budgets, Revenue and profit and Expiries and the calendar.
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.
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.
- 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. - 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."
- Press the comparison ("vs previous 30 days") and choose Previous period, Same period last year or None.
⇧Cturns it on or off. - 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
- Open incident
- Takes you to
- The incident on Alerts
- Action
- Reconnect
- Takes you to
- The connection, on Connections' Connected tab
- Action
- Mark renewed
- Takes you to
- Stays here: the expiry moves to its next date, and the page says "… is renewed." with Undo
- Action
- Open provider
- Takes you to
- The project's Obligations tab. A one-time obligation has this and no Mark renewed: it has no next date, so change it there.
- Action
- See costs, See runs, See usage
- Takes you to
- The tab with the figures behind it
- Action
- Review
- Takes you to
- The binding review
| Action | Takes you to |
|---|---|
| Open incident | The incident on Alerts |
| 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:
- Press Snooze. With the keyboard, tab to a button in the row and press
s. - Choose 1 day, 1 week or Until it changes.
- 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.
- You see
- "3 of 3 projects"
- It means
- Every project you see is counted.
- You see
- A copper dot and "Costs from 8 of 12 projects"
- It means
- Some projects have no source yet. The figure counts only the others.
- You see
- "so far" and "Complete through Nov 3 · later days so far"
- It means
- The period isn't over. Every source is complete through Nov 3, and later days count what has arrived so far.
- You see
- A clock and "Stale since 09:14 · Stripe needs you to sign in again"
- It means
- The source stopped reporting. The figure is the last known one, muted. Owners and admins get Reconnect.
- You see
- EST and "Includes $310 estimated (EST)"
- It means
- A fifth or more of the figure is estimated rather than billed.
- You see
- "EUR amounts not converted: no rate."
- It means
- The amounts in that currency are left out until a rate is in.
- You see
- "Backfilling older history · through 2025-03"
- It means
- Older months are still loading.
- You see
- "First full period ends Nov 24"
- It means
- A source is too new for a full period, so a change isn't meant yet.
- You see
- "3 of 3 projects · plus revenue not yet split by project", or "Across the workspace · not yet split by project"
- It means
- Revenue no project takes yet is counted. Owners and admins get Review bindings (see Review bindings).
| 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). |
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).
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,HomeandEndjump,Enteropens what a mark leads to andEsclets go. On Revenue and costs and MRR, pressing a day (orEnter) 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.
tdoes 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
non 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 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).
- 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,
jkmove between rows and⇧Ppins 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. 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:
- Press Explore a sample portfolio. Every tab opens with made-up figures for "Sample studio".
- The banner says "Sample data · nothing here is yours" on every tab. Move between the tabs as usual.
- 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
1to6- Does
- Go to a tab
- Key
p- Does
- Open the period menu
- Key
⇧C- Does
- Turn the comparison on or off
- Key
e- Does
- Explain the focused card
- Key
s- Does
- Snooze the focused row of Needs you
- Key
/- Does
- Filter projects
- Key
jk- Does
- Move between projects
- Key
⇧P- Does
- Pin the focused project
- Key
←→,Home,End- Does
- Move along the focused chart
- Key
t- Does
- Show the focused chart as a table
- Key
n- Does
- Add a note on the focused day, if you can
| 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.
When it doesn't work
- The page says
- "That didn't start. Try again."
- What to do
- Sync now didn't reach the connection. Try again, or open it in Connections.
- The page says
- "That didn't save. Try again."
- What to do
- A snooze or a pin wasn't saved. Check your connection and try again.
- The page says
- "The rest didn't load."
- What to do
- Press Try again. The table keeps what it has.
- The page says
- Page not found
- What to do
- You don't have that tab, or the page's address is wrong.
| 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. |
| "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. |