IRR Function in ONLYOFFICE Spreadsheet Editor: Syntax, Worked Examples and Limitations
Step-by-step ONLYOFFICE IRR function tutorial with verified vendor syntax, financial worksheet examples, independent numerical expectations and troubleshooting.
Verification status: See the evidence and test scope described in this guide. How formula examples are checked
IRR finds a discount rate that makes a regularly spaced cash-flow series have zero net present value. It returns a rate per period, and the cash-flow amounts may differ from one period to the next.
Availability and version history
- Introduced: The original introduction release and date are not established by the official sources checked.
- Availability: Documented in the current ONLYOFFICE Spreadsheet Editor help; no final working-version endpoint is established.
- Scope: Docs and Desktop Editors release separately. The unversioned reference does not establish support in every older build or mobile client.
- Checked: October 14, 2026, against the official IRR reference. Documentation check; not a new native test.
Exact vendor syntax and argument order
=IRR(values, [guess])
| Position | Argument | Type and role | Omission/default |
|---|---|---|---|
| 1 | values |
Required array/range of numeric cash flows at equally spaced periods, with at least one negative and one positive | No default |
| 2 | guess |
Optional numerical starting estimate for iterative calculation | 10% |
The cash-flow range must include at least one positive and one negative value. guess is optional and defaults to 10%; type 0.1 or 10%, not 10.
Mathematical explanation — independent from runtime claims
For cash flows C0, C1, …, Cn at regular times, an IRR root is a rate r satisfying 0 = Σ(Ct/(1+r)^t) for t=0...n. This is an independent economic definition and numerical model. The ONLYOFFICE reference confirms the regularly spaced cash-flow input and the optional guess, default 10%; it does not promise a unique root or spell out convergence thresholds. The expected rates in the table were solved independently and checked by discounting every input cash flow back to a near-zero residual.
Set up the cash-flow ranges
Use a blank worksheet. A semicolon in the setup table separates consecutive cells; do not type the whole sequence into one cell. Keep inputs numeric and put results in column M, starting at M2, without overwriting any input range.
| Cell or range | Enter this value (or consecutive cells) | Meaning |
|---|---|---|
B2:B4 |
-1000; 600; 600 |
Three annual cash flows from top to bottom |
C2:C3 |
-1000; 1100 |
One-year 10% example |
D2:D4 |
-1000; 0; 1210 |
Two-year 10% with a zero payment |
E2:E5 |
-10000; 3500; 4500; 4200 |
Multi-year project |
L2:L3 |
-1000; 900 |
A loss-producing annual project |
Worked examples
Expected rates below are decimal fractions shown to six places, so 0.100000 means 10%.
| # | Enter in an unused output cell | Expected model result | What this demonstrates |
|---|---|---|---|
| 1 | =IRR(B2:B4) |
0.130662 |
Initial outlay and two receipts |
| 2 | =IRR(B2:B4,10%) |
0.130662 |
Explicit documented 10% guess |
| 3 | =IRR(C2:C3) |
0.100000 |
One-period rate |
| 4 | =IRR(D2:D4) |
0.100000 |
Zero cash flow still occupies a period |
| 5 | =IRR(E2:E5) |
0.103100 |
Unequal project inflows |
| 6 | =IRR(L2:L3) |
-0.100000 |
Negative annual return |
Advanced uses and audit-ready patterns
Verify the rate by independently rebuilding net present value
With =IRR(B2:B4) in M2, put =B2+B3/(1+M2)+B4/(1+M2)^2 in M14. On the independent model this should be close to zero (small residuals are possible from numerical precision). The first flow at time zero must not be discounted. This check catches a common timeline error.
Keep empty periods instead of deleting them
For D2:D4 the middle payment is explicitly numeric zero. That preserves the two-year gap between initial payment and the final 1,210 receipt. Deleting the zero row would turn a two-period investment into a one-period investment and change its annualized return. Ensure cash flows are equally spaced and in chronological order; IRR has no explicit date-array argument.
Make sense of the initial guess
The vendor describes guess as an optional estimate and defaults it to 10%. For ordinary single-change-sign flows, a reasonable alternative guess will often locate the same economically meaningful root; that is a numerical expectation, not a vendor guarantee. For the separate series -100,230,-132, both 10% and 20% make the discounted sum zero. Multiple changes of sign can produce several real solutions or no usable solution. If a result changes with the guess, examine the full cash-flow polynomial and alternative rates instead of presenting one figure as uniquely correct.
Do not confuse IRR with MIRR and NPV
NPV discounts a specified stream at a user-supplied rate. MIRR explicitly separates borrowing and reinvestment rates. XIRR accepts date-aware cash flows. IRR itself assumes a regular timetable; it is unsuitable for irregular timestamps without translating them into appropriate periods.
Translate the period correctly
An IRR from monthly cash flows is monthly. For a periodic rate r, a mathematical effective annual equivalent under monthly compounding is (1+r)^12−1; this is an independent annualization calculation, not a feature built into IRR. Avoid writing r×12 as a universally exact annual effective rate.
Use an investment decision framework, not IRR alone
A higher reported IRR is not necessarily a better project when project sizes, reinvestment assumptions, constraints or risk differ. Compare present values at a chosen hurdle rate, the size and timing of cash flows, and project risk. The formulas shown are examples for education, not investment advice.
Troubleshooting: limits, ambiguous behaviour and common errors
| Symptom or pitfall | What to verify |
|---|---|
| No usable rate is found | The vendor requires at least one negative and one positive value. Examine the initial guess and sign pattern. Exact native failure code/iteration count is not documented here. |
| Result seems a factor of twelve too high | Determine whether each row is a month or year; IRR returns a per-period rate. |
| Formula output changes after deleting a zero row | A zero cash flow can preserve a period. Restore the timeline rather than compressing it. |
| Formula returns an unexpected branch | Multiple sign changes can yield multiple mathematical roots. Evaluate residuals and disclose the selected guess. |
10 typed as a guess |
The default is 10%, which is 0.10, not 10 (1000%). Use 10% or 0.1. |
| Differences vs XIRR or XNPV | The latter rely on dates. IRR treats adjacent cells as equally spaced periods. |
The short official reference does not specify every invalid-input error token, coercion rule or solver limit. Check numeric inputs and the actual error explanation rather than assuming another spreadsheet’s behavior.
Entry settings and verification
Examples use English function names, commas and numeric decimal rates. The function-entry guide describes the function dialog; Advanced Settings covers formula language and regional formatting. ROUND explains deliberate numeric rounding, and SUM helps build cash-flow checks.
Expected values were independently calculated from the stated financial equations and separately cross-checked. No example was executed in ONLYOFFICE. Fixed-rate models omit fees, taxes, irregular dates and contractual rounding unless those assumptions are added explicitly.