Skip to content
Guides

Expiries and the calendar

The Obligations tab holds what has a date and no API to warn you: memberships, certificates, keys, renewals. ShipVitals also tracks the domains and certificates it watches. It reminds you before each one is due, and your calendar can do the same.

Everyone who sees a project sees its obligations. What you can do depends on your role:

  • Owner and Admin: everything, including Add obligation.
  • Editor: Mark renewed, Edit, Change split and Delete on an obligation whose projects they all edit.
  • Viewer: reads them, with Add to calendar.

Without amounts, a figure shows "—" and Amount hidden. An obligation shared with a project you can't see counts it ("1 project you can't see").

Open it

Open Obligations on the Portfolio (press 6, or 4 without amounts, or the tab) for every project, or on a project for its own. Expiring this month in the command palette (⌘K / Ctrl K) shows the ones within 30 days, with Show all to go back.

The expiry radar

Expiry radar · next 90 days puts today at the left, with bands at 60, 30, 7 and 1 days, and a dot on each date. A dot's colour and its mark say how close it is. Something overdue sits at today's edge and says so. The sentence above it counts them: "8 renewals in 90 days; 1 is overdue, 2 are inside 7 days, 2 are inside 30."

  • Press a dot to go to its row.
  • With the keyboard, tab to the radar. ← → walk the dots in date order, each read in full, Enter goes to its row, and t opens the table.
  • On a phone, tap a dot to read it.
  • Show as table lists the Name, Projects, Date, Days left, Renewal amount and Next alert.

With nothing near, it says "Nothing renews in the next 90 days."

The Portfolio's Overview has a smaller radar beside its chart, and the Next expiry card names the nearest.

The list

Rows are grouped by Overdue, This week, This month, Next 90 days and Later. Each shows its kind, how it renews, its date and its source ("Subscription · Yearly · due 2026-11-11 · Manual"), the days left, the amount, when you'll be alerted ("Alerts on 2026-11-10.") and its projects.

A shared one says what falls to this project: "Shared with 2 other projects · your share 33% ($40.01/yr)". A row from a connection or obligations.yaml says "From a connection or obligations.yaml. Change it there."

Mark something renewed

  1. Press Mark renewed on a recurring one, on the row or in Needs you.
  2. The date moves to the next one and the page says "… is renewed." with Undo.

Open provider opens the provider's page for renewing it, in a new tab, where it has one.

Add one

Owners and admins:

  1. Press Add obligation. Add an obligation opens.
  2. Choose a template, or Something else.
  3. Fill in Next renewal or deadline ("Year, month and day, like 2027-04-30."), Renews and Projects, and the Amount if it has one. See Connect a service.

Change one

  1. Press Edit. The form opens in place of the row.
  2. Change what you need. Change the alert days sets Alert days before it's due ("Up to 10, separated by commas, like 60, 30, 7, 1.").
  3. Press Save. The page says "Saved …."

To change how a shared one is split, press Change split, type each project's share and press Save. The shares must add up to 100%.

To delete one, press Delete. The row asks "Delete …?": "Its alerts stop, and it goes from every project it shows on. This can't be undone." Press Delete to confirm, or Cancel.

Subscribe in your calendar

A link of your own, showing every obligation you can see, with alerts on the same days. Your calendar keeps it up to date.

  1. Press Subscribe in your calendar on the Obligations tab, or on the Alerts page's Delivery. Subscribe to calendar in the command palette goes there too.
  2. Press Get my link. The page says "Your calendar link is ready."
  3. "This is the only time it's shown. Copy it or add it now." Press Copy your calendar link, Open in Apple Calendar or Add to Google Calendar now.
  4. Press Close.

Anyone with the link can read your obligations, so keep it to yourself. ShipVitals keeps only a scrambled copy and can't show it again. Coming back, the panel says "You've had a calendar link since Nov 5, 2026. Only you can reset it, and calendars using it keep updating."

To replace it:

  1. Press Reset link.
  2. The panel asks "Reset your calendar link?": "The old link stops at once, and every calendar using it stops updating until you add the new one."
  3. Press Reset link to confirm, or Cancel (or Esc).
  4. The page says "Your old link no longer works. Here's the new one."

For a single date, Add to calendar on a row saves a calendar file: "Saved …'s calendar file."

The sample portfolio has no calendar.

When it doesn't work

  • The page says
    "That didn't work. Try again in a moment."
    What to do
    Nothing changed. Try again.
  • The page says
    "Your calendar link's state didn't load. Try again in a moment."
    What to do
    Reload the page.
  • The page says
    "Adds up to 90%. It must add up to 100%."
    What to do
    Change the shares.
  • The page says
    "This one comes from a connection or obligations.yaml. Change it there."
    What to do
    Change it at its source.
  • The page says
    "This one doesn't recur. Change its due date instead."
    What to do
    Press Edit.
  • The page says
    "Its date has changed since that renewal, so it can't be undone."
    What to do
    Press Edit to set the date.
  • The page says
    "Setting an amount needs access to the financials of every project it serves."
    What to do
    Ask an admin to set it.
  • The page says
    "The obligations didn't load. Reload the page to try again."
    What to do
    Reload the page.