Answered from these docs only, by a model that cannot see your account. Check the pages it cites.

The initiative lifecycle

The stages from Identified to Completed, the buttons that move an initiative, and who can approve each step.

View as Markdown

Answered from these docs only, by a model that cannot see your account. Check the pages it cites.

Checked against the product on November 9, 2026

Every initiative moves through the same stages, and the step from Reviewing to Implementing is an approval.

The stages

  1. Identified — proposed; nothing committed yet. A new initiative starts here, unless it was imported from a spreadsheet or document that gave it a stage of its own.
  2. Reviewing — submitted for a decision.
  3. Implementing — approved; the work is underway.
  4. Live — in use, and value should be accruing.
  5. Completed — finished, or retired by a portfolio decision.

Off the main path:

  • Paused — stopped for now, from Identified, Reviewing, Implementing or Live. Resume returns it to the stage it was in. One paused while it was live comes back by a portfolio decision instead: continue, scale or fix resumes it.
  • Rejected — turned down at review, with a reason the owner can read.
  • Dismissed — dropped after work began (from Implementing, Live or Paused).

An initiative set up twice isn't dismissed: merge the duplicate into the other, which keeps its costs and value counted. See Merging a duplicate initiative.

Completed, Rejected and Dismissed are final. Completing an initiative doesn't lock its figures: its entries can still be edited, except those in a month someone has locked, which stay as they are until the month is reopened with a reason.

Dismissing an initiative asks why, and stops new costs booking to it from what was routed there. From the day it's dismissed, it comes off every allocation rule that splits to it: a rule it was alone on is archived, and one it shared is replaced by a rule without it, whose share for it books to no initiative. Its vendor mappings book no new bills, keeping only those they had already booked, and its recurring costs stop after that month.

A provider connected to it as a cost source, such as Anthropic, OpenAI, GitHub or a cloud, keeps booking what it reports for the initiative, because a charge there means something it ran is still running. The dialog lists each of these before you confirm, and the audit log records each rule it changes. Costs and approved value already on it stay counted.

Its plan leaves the portfolio's full-horizon plan, the Planned cash value on Home and the Totals on ROI → Initiatives, because it will deliver none of the rest; the months it ran stay in each plan to date. A rejected initiative's plan is left out the same way. Pausing, completing or retiring an initiative changes none of this: their costs keep booking.

How stages change

Open the initiative. The button at the top right is the next step:

  • Submit for Review (Identified). If the Health tab still has items to do, Roiva warns you before submitting, because a reviewer would see a number held for review or no number at all.
  • Approve (Reviewing) moves it to Implementing.
  • Mark as Live (Implementing), Resume (Paused before it went live).
  • Record Decision (Paused while live), if you can decide on it: continue, scale or fix resumes it, with a reason.
  • Record Decision (Live, once it has approved value), if you can decide on it: continue, scale, fix, pause or retire it, with a reason. See Portfolio reviews and decisions. Until then there's no figure to decide on, so the button is Open Health, which lists what it needs to be measured.

The … menu beside it has Already live or completed? before it's live, which records that it was running before it was tracked here (see below), then Pause, Reject (Reviewing only; it asks for a reason) and Dismiss. On a live initiative, Pause and Mark as Completed open Record Decision with Pause or Retire chosen, because pausing or completing a live initiative is a portfolio decision, kept with its reason and the figures it was made on; the menu also has Change Go-Live Date, and Record Decision while the button is Open Health. You can also click an earlier stage in the stage bar to move back. Moving back to Reviewing or earlier restarts the approval. A live initiative goes back only to Implementing, and that is a portfolio decision too: clicking Implementing opens Record Decision with Back to Implementing chosen.

Any member can submit, mark as live, pause or resume an initiative that isn't live yet, and move back one that isn't live. Pausing, completing or moving back a live initiative, and resuming one paused while live, is for an Owner, an Admin or the initiative's approvers, and pausing, completing, dismissing, moving back or resuming one is a portfolio decision. Approve, Reject and Dismiss are approvals, and so is recording a go-live date.

Who approves

Each initiative can name an Approval chain on its edit form: up to five steps, each with its own approvers, approved in order. The stage changes only after the last step. With no chain, any Owner or Admin approves, and above the Senior approval threshold in Organization Settings → Approvals, only an Owner can. See Approving value and initiatives.

Decisions are recorded: the Overview shows who approved and when, and a rejection's reason shows as a review note. For anything else worth writing down, Activity → Add Note records a general note, a decision, a blocker or an update. See Activity, notes and blockers.

Costs and value at any stage

Costs and value entries can be recorded in any stage, though not into a locked month (see Allocation rules and accounting periods). Measurement usually starts once an initiative is Implementing or Live.

An initiative that was already running

Most AI tools are in use before anyone tracks them here: a coding assistant rolled out in the spring, a help desk's AI agent switched on months ago. Choose Already live or completed? in the initiative's … menu and enter the date it went into use. When you add your first initiative during setup, tick It's already in use and give the month: the initiative then opens with this dialog filled in, for you to record. The initiative becomes Live from that date, and Roiva:

  • measures its baseline from the three complete months before that date, where your connected systems have them. A baseline you entered yourself stays as it is. If those months have no history, Roiva removes a baseline it had calculated from later months, which already carried the initiative's effect, and the Health tab asks for one.
  • calculates each complete month since, as far back as your readings go. A month is calculated only when every reading in it describes that month, and none is calculated while the baseline is still Roiva's estimate. A month waiting only on a figure you set once, such as the share of the change credited to the initiative, is calculated when you set it.
  • sends those entries to their approvers' Inbox. Recording the date approves none of them.

Where no connected system holds a figure its formulas read each month, Roiva opens Past months once you've recorded the date: a row for each complete month since, with a field for each figure, so you can type in what you have from your own records. If your account lets AI assistants draft changes, your assistant can draft these months for you to accept instead (see Connecting Claude, ChatGPT, Cursor and other AI assistants (MCP)). A month is calculated once all of its figures are in, and not while its baseline is still Roiva's estimate; its entry is approved as any calculated entry is. A figure the month already has is shown there, not changed (correct one under Entries → Metric Entries), and a month a formula has already booked takes no new figure. Missing Inputs links to it too, from a formula waiting on this month's figures.

Recording the date takes approval rights, because it decides which months count as before and which months book value. On an initiative that isn't approved yet, it also approves it, in your name, and the decision is in the approvals history. If the initiative has an approval chain with later steps, approve it through review first. The date can't be in the future.

On a live initiative, Change Go-Live Date corrects it. Activity keeps the date it replaced, and the baseline and the months are worked out again from the new date. The months a connection syncs later are calculated the same way.

The time-to-value estimate

Est. time to value on the initiative's form is the number of months you expect to wait, from when work begins, for the first approved value entry. Value is dated by the month the entry covers, not the day it was approved: an initiative recorded as live since March whose months were all approved in September delivered in March. Roiva measures the schedule against it: the initiative page says how far past it you are and what the wait has cost at the planned value rate, the review report carries a Schedule row, and the portfolio snapshot totals what slipped initiatives have deferred.

Two things follow from that. Months an initiative spends Paused push the date out, so a held initiative isn't counted late. And without an estimate there is nothing to measure against — those surfaces say so rather than showing an initiative as on time. The Health tab lists a missing target as an open item.

Changing the estimate later is recorded in Activity, with the old and new figures, so a target that moved after an initiative was already late is visible.

Next