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

Adding costs and value entries

Record costs and log value by hand, record freed capacity that became cash, set up recurring costs and vendors, import a spreadsheet, and planned figures.

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

Costs and value entries are what every ROI figure in Roiva adds up. You can record them by hand, import a spreadsheet, or let connected systems and value formulas record them for you.

Recording a cost

An initiative's costs are what you pay to run it: its tool's seats or usage, vendor fees, implementation, consulting, your own team's time. Leave out spend that serves other work, even when it's on the same vendor's bill. For an AI coding assistant rollout, say, the assistant's seats for the engineers in the rollout count, and the same provider's API usage for a product feature doesn't.

Every template names what typically counts for its kind of initiative and what usually stays out. They're guidance, not rules: an initiative's costs are whatever it actually pays to run. The coding assistant, for one, leaves out the GitHub plan the assistant runs on, which you'd pay for anyway. You'll find the two lists on the template's page, on the Costs tab, in the cost form and on the Health tab. An initiative that didn't start from a template gets the general version.

Open the initiative's Costs tab and choose Record a cost, under Add costs once the tab has a cost:

  • Cost type — software, tokens, implementation, infrastructure, data licensing, consulting, internal labor, maintenance or severance
  • Cost category — CapEx or OpEx. Implementation defaults to CapEx and everything else to OpEx.
  • Amount and the period it covers, which is required: monthly reports, the board brief and a month's close all read it. An OpEx cost whose period spans several months, such as a year's license paid up front, is recorded as one entry a month, each its share of the amount by days, so each quarter carries the months it paid for. A CapEx cost stays in its month. An amount you type is in US dollars. A cost synced from another system keeps its own currency, shows its dollars beneath it, and counts in totals at the European Central Bank's average rate over its period (or the latest rate, marked provisional, until that period's rates are published). A cost can't be negative; record a credit by lowering the cost it reduces.
  • Optional: a source reference (an invoice or PO number), notes, and This is an estimate

For a cost that repeats (a monthly subscription, say), choose Set up a recurring cost instead: a schedule that records a cost entry each period for you. See Vendors, shares and recurring costs.

If your AI assistant is connected to Roiva and your account lets it draft changes, it can also draft the charges on a vendor bill Roiva doesn't connect to as the initiative's costs. The draft waits under Inbox → Proposals, where you book the lines you want; what starts unticked, and why, is in Connecting Claude, ChatGPT, Cursor and other AI assistants (MCP).

A vendor's own connection that bills by the day, such as GitHub's Copilot charges or a model provider's usage, books one cost entry per line item per day. The list shows each line item's month as one row and says how many entries it holds; open the row to see each day, with its own edit and delete. The Total row and Export count every entry. A bill or card charge from your books stays one row each. A lock in place of a cost's actions means its month is locked.

The Costs tab has two more views:

  • Vendors — which vendors' bills book to this initiative from a connected finance system (QuickBooks, Xero, NetSuite or American Express statements), how each vendor is matched, and what share of each bill counts.
  • Budget — what the initiative was approved to spend, against what it has spent. See Budgets and budget vs. actual.

A cost counts toward ROI as soon as it's saved, so changing or deleting one is recorded in the audit log with what it was. No cost can be recorded, changed or deleted in a locked accounting period until someone reopens it (see Allocation rules and accounting periods).

Logging value

Open the Value tab and choose Log value, under Add value once the tab has an entry:

  • Entry type — revenue gain, cost savings or cost avoidance, which are cash; freed capacity; or capacity realized as cash (see below). A cost isn't value: record it on the Costs tab, where ROI nets it against value. A revenue gain is the margin on the added revenue, not the revenue itself: what's left after the costs that grow with a sale. Formulas and synced deals, invoices and payments book it that way, so enter yours the same way. Hours your team got back, at whatever rate, are freed capacity, not a cost saving: payroll is the same afterwards
  • Amount, in US dollars, and period. A period spanning several months is saved as one draft a month, each its share of the amount by days, because value counts in the months it was earned. Every month has to have ended: record the months that have, and the rest as each one ends. Once an initiative has started, no month before its start can take new value, from a person, an import, a sync or a formula: those months are the before its baselines describe. An entry already approved for such a month stays approved. Work starts when the initiative is approved, or on the go-live date you record for one already in use; an Owner or Admin can change it under More Options on the initiative's Edit form.
  • Optional: notes, a confidence score (0–100) and This is an estimate
  • Optional: Supporting documents — check any of the initiative's documents the figure rests on, or add a link to the spreadsheet, invoice or report. A link you add is saved to the initiative's documents as well.

An entry you log is saved as a draft.

Supporting documents are what an approver opens. A formula's entry shows the inputs it was calculated from, and a synced entry the records it came from. An entry you typed shows the documents it cites, or No source attached. So does a formula's or a synced entry once you change its figure: its source then ends "then edited by hand".

While it waits for approval, a recalculation of the formula, or a sync that brings in a changed record, can write the formula's or the sync's figure over yours, and the source then no longer says it was edited by hand.

Citing is optional, but an approver sees which it is, and reports say how much approved cash rests on entries with no source attached. Changing an approved entry's documents sends it back for approval, like any other change. An SOW or contract you cite is listed only for the people who can open it; everyone else sees that one is there.

Notes are where you say why. The amount says what the figure is; the note says what moved it, and it's the first thing an approver reads. It matters most on a cost saving, where the question is always the same one: did your team earn this, or did a vendor hand it to you? Routing simple requests to a smaller model is your saving. A provider cutting its list price is not, even though both show up as the cost falling. Say which it was.

Where the saving is a drop in what your AI spend buys, and Roiva can read your provider's bill, it works that split out for you and shows it on the entry — see How value is calculated. Everywhere else, the note is the record.

Recording capacity realized as cash

Freed capacity is reported beside cash value and is in no ROI, because the hours are freed but payroll is the same. It becomes cash when something the books can see changes: a hire that was planned and not made, a role closed so its payroll stopped, overtime, contractor or outsourcing spend that fell, or growth absorbed without adding staff. Roiva can't see that on its own, so a person records it:

  1. On the initiative's Value tab, choose Add value → Log value and pick Capacity realized as cash as the entry type. Once an initiative has approved freed capacity, Record capacity realized as cash on its page under ROI → Initiatives, and on its Formula Trace, opens the same form.
  2. Enter one calendar month, and the amount of that month's freed capacity that became cash.
  3. Say in the notes what changed.
  4. Cite the document that shows it under Supporting documents: a canceled requisition, a closed position with payroll before and after, a contract not renewed, an overtime report, or a vendor's invoices before and after. It can be saved as a draft without one, but not submitted.

A closed role counts from the month its payroll stops, not the month it was decided.

What closing it cost is a cost of the initiative: record it on its Costs tab under the Severance cost type, so ROI nets it. Severance is OpEx, covers the one month it's paid (paid over several months, record each month on its own) and has no vendor. Record the amount, the month and a note, and under Source Reference point to a payroll record by group, such as a summary for the team. Don't name the person or give an employee ID: every member of the account reads that table.

It isn't AI spend, so it's in none of the AI figures on AI Spend; that page's All vendors view, which lists every cost, shows it under No vendor named. It counts against the OpEx budget, though a budget's monthly run rate leaves it out.

For a closed position, cite a record by position or by group, such as a payroll summary for the team, rather than one that names the person.

For a change that holds month after month, like a contract not renewed, Repeat monthly through records one entry for each month with the same amount, notes and documents. It records only months that have ended, so nothing books after the last month you choose. An entry's Booked Through line shows that month.

Once the month after the last one ends with nothing booked, the Inbox asks about it. The row waits on the initiative's owner, though any member can answer it. Record opens a new entry filled in from the last month, which still needs submitting and approving. It stopped asks why and records the last month, and the Inbox stops asking. Recording a later month, or deleting that last one, brings the claim back. If it stopped earlier, delete the months after it instead: an approved month takes an approver to delete, and a month in a locked period has to be reopened first. The same applies to payroll beyond freed capacity. The Inbox doesn't ask about a completed, rejected or dismissed initiative, or about sample data once the account has initiatives of its own.

An approver can approve it only up to the initiative's freed capacity approved for that month, less what other realizations already took. Once approved, it counts in cash value and comes out of freed capacity, so the dollar is counted once. While it stands, the freed capacity it drew on stays approved: that month's capacity entries can't be edited, sent back or deleted if what's left would be less than what was realized. Send the realization back for review first. "We would have hired someone" on its own stays capacity: an avoided hire needs a decision with a date on it. A bill that fell by more than the freed hours explain, because a rate fell too, say, is an ordinary cost saving on its own evidence. Payroll that fell by more than they explain isn't value from those hours.

Formulas, syncs, imports and document extraction never record it. It's always a person's call, with the evidence attached.

Recording payroll beyond freed capacity

A closed role's payroll can fall by more than the month's freed capacity: $50,000 a month against $20,000 of capacity. Record the $20,000 as capacity realized as cash, then the $30,000 this way:

  1. Pick Payroll beyond freed capacity as the entry type, and enter one calendar month, from the month the payroll stops.
  2. Say in the notes which role closed and when its payroll stopped.
  3. Fill in Why this isn't value already counted.
  4. Cite a closed-position record with payroll before and after under Supporting documents.

It can be approved only once the initiative's approved freed capacity for the month is all realized, and only by someone who didn't record or edit it. Allowing self-approval in settings doesn't change that, and an account's only approver has to bring in a second person. Auto-approve never applies. It counts in cash value, stays out of freed capacity, and the Board Brief and Value Evidence Register show it apart from cash realized within freed capacity.

Most value doesn't need typing in: an initiative's value formulas calculate entries from its readings and assumptions, and value integrations (Zendesk, HubSpot, Stripe…) book what they sync.

Value needs approving

Only approved value is reported: cash counts toward ROI, and freed capacity is reported beside it. Entries an integration calculates go straight to approvers, and a formula's go to them once the month they're for has ended. A draft, or an entry an approver disputed, goes to them when you choose Submit for review. Approvers Approve or Dispute it from their Inbox. Only an entry waiting for approval can be disputed. See Approving value and initiatives.

Anyone can edit a draft or an entry waiting for review. An approved entry is different: changing or deleting it takes someone who could approve it, and sending it back takes an approver, who may be the person who prepared it. Saving any change sends it back for approval, and so does Send Back for Review on the entry, which leaves everything alone and asks for a reason. In a locked month an approved entry can't change at all until the month is reopened, and its page says so.

Importing a spreadsheet

Imports cover every initiative at once. Open Entries → Cost Entries (or Value Entries) and choose Import:

  1. Download Excel Template and fill it in. It's an Excel workbook with a dropdown on every column that has a fixed set of answers, and a Definitions sheet saying what each column takes; the upload page links a CSV template too. Each row names its initiative in initiative_name (or initiative_id), and the upload page lists the required and optional columns.
  2. Upload the file, as an Excel workbook (.xlsx) or a CSV. It's processed in the background, and you get a notification when it's done. Rows are saved as they're read, so the workbook has no example row to delete. A cost counts as soon as it's saved; a value entry is saved as its status column says, a draft by default, and counts once it's approved.
  3. The import's page lists how many rows came in and why any were skipped. Valid rows are saved even when others fail, so fix the skipped rows and import just those.

A value entry row's status can be draft (the default), reviewed (sent to approvers, and shown as Submitted) or approved, which takes someone who could approve the entry and a month that isn't locked. Rows with any other status are skipped.

An initiative's own tabs offer the same import for just that initiative: Import a spreadsheet on its Costs tab and on its Value tab, under Add costs and Add value once each has an entry. Imported costs take CapEx or OpEx from their type. Baselines and readings import from Entries → Metric Entries → Import.

Planned figures

Entries are what actually happened. What you planned to spend and gain lives on the initiative itself: its business case (planned CapEx and OpEx, planned cash value as cost savings, cost avoided and revenue uplift per period, planned freed capacity per period, and the time horizon).

Cost savings is a cost you pay that falls, which the ledger shows. Cost avoided is a loss or a spend that would have hit the books and won't, such as write-offs or penalties below their usual rate, or a vendor quote or approved hire you no longer need. It's cash too, but it rests on the record of what was coming, so keep that record with the business case.

Planned freed capacity sits beside the cash plan, and no planned ROI includes it. Enter the revenue uplift top line, as a business case document usually states it. It counts toward planned cash value at your contribution margin, the same way booked revenue does, so until a margin is set, for the account under Method → Assumptions or for the initiative on its Health tab, it counts as nothing.

Set them with Edit Business Case, under Edit in the initiative's … menu or on its page under ROI → Initiatives. Approval sets the initiative's budget from its CapEx and OpEx, and editing them afterwards leaves that budget as it is.

If the business case is already a document, pick it under Fill from a document at the top of Edit Business Case: a Business case on the initiative's Documents section, or a PDF, Word, PowerPoint, Excel, CSV or text file to upload. Then choose Read it. Roiva sends its text to Anthropic's Claude, which finds the planned figures. An upload is added to the Documents section as a business case, unless the section already has that file, so uploading it again doesn't file a second copy.

Each one then shows under its field, for the period the form is set to, with the words it came from. A total over three years is shown as a year's share of it. Choose Use for the figures you want, or Use all, then check them and save. Nothing changes until you save.

It isn't offered with Aggregate Figures Only on. The ROI dashboard sets the plan and the actuals side by side.

Next