# 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](connect-a-service.md).

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