PPMT Function in ONLYOFFICE Spreadsheet Editor: Syntax, Examples and Troubleshooting
Calculate the principal share of a payment period with ONLYOFFICE PPMT.
Verification status: See the evidence and test scope described in this guide. How formula examples are checked
PPMT tells you how much of one scheduled payment reduces the original debt. It separates principal from interest, making it useful for a remaining-balance ledger or a payment breakdown.
Availability and version history
- Introduced: The original 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. This unversioned reference does not establish support in every older build or mobile client.
- Checked: October 14, 2026, against the official PPMT reference. Documentation check; not a new native test.
Syntax and arguments
=PPMT(rate, per, nper, pv, [fv], [type])
| Argument | Meaning | Default |
|---|---|---|
rate |
Interest rate per payment period | Required |
per |
Payment number to inspect, from 1 through nper |
Required |
nper |
Total scheduled payments | Required |
pv |
Signed value at the start | Required |
fv |
Signed balance targeted after the last payment | 0 |
type |
0 for period-end payments; 1 for period-start payments |
0 |
Square brackets mark optional arguments; do not type them. A positive loan advance represents money received, while the repayment components are negative outflows. These conventions and defaults follow the official PPMT help.
Set up a loan example
In a blank worksheet enter the following. Keep these inputs unchanged when trying the formulas below in unused cells.
| Cell | Enter | Purpose |
|---|---|---|
B2 |
=6%/12 |
Monthly rate, 0.005 |
B3 |
60 |
Five years of monthly payments |
B4 |
10000 |
Loan amount received |
B5 |
0 |
No target balance after the last payment |
B6 |
0 |
Payments at month end |
=PMT(B2,B3,B4,B5,B6) gives an expected payment of -193.328015. PPMT returns only the principal within that payment, not the full installment.
Worked examples
| Formula | Expected result | Meaning |
|---|---|---|
=PPMT(B2,1,B3,B4) |
-143.328015 |
First monthly payment |
=PPMT(B2,2,B3,B4) |
-144.044655 |
After one principal reduction |
=PPMT(B2,60,B3,B4) |
-192.366184 |
Final scheduled payment |
=PPMT(B2,1,B3,B4,0,1) |
-192.366184 |
First payment made immediately |
=PPMT(B2,2,B3,B4,0,1) |
-143.328015 |
Second beginning-of-period payment |
=PPMT(0,1,12,1200) |
-100.000000 |
Zero-interest comparison |
=PPMT(B2,1,B3,-10000) |
143.328015 |
Reverse the cash-flow perspective |
=PPMT(B2,12,B3,B4,-2000,0) |
-121.128894 |
A signed nonzero terminal target |
Why principal grows over time
The full payment is fixed, but interest is charged on a declining balance. In month one, -193.328015294 - (-50) gives principal -143.328015294. By month sixty, only about -0.961831 of the installment is interest, leaving approximately -192.366184 as principal.
Do not calculate principal as 10000/60: that would assume equal principal reductions rather than equal total payments.
Build a remaining-principal ledger
Enter period numbers 1 through 60 in D2:D61. In E2, enter:
=PPMT($B$2,D2,$B$3,$B$4,$B$5,$B$6)
Fill down through E61. In F2, enter the following and fill down through F61:
=$B$4+SUM($E$2:E2)
The sum’s first endpoint stays fixed while its second endpoint expands. Add the negative principal components to the positive opening balance.
| Checkpoint | Expected remaining principal |
|---|---|
After payment 1 (F2) |
9856.671985 |
After payment 12 (F13) |
8231.968328 |
After payment 60 (F61) |
0.000000 |
The full-term sum =SUM(E2:E61) is -10000 in the mathematical model. Tiny numerical residues may appear in a spreadsheet. This ledger assumes the unchanged scheduled payments; an extra repayment requires recalculating subsequent balances and interest.
Payment timing and a terminal balance
With type=1, the first payment is made before any period’s interest accrues. Its interest component is zero and the payment is entirely principal. Change timing consistently in PMT, IPMT and PPMT; keeping the old PMT amount would mix two schedules.
For the table’s fv=-2000 case, scheduled payments leave a positive modeled debt balance of 2,000. The signed terminal amount is negative from the borrower’s perspective. This is not an extra recurring payment: it changes the payment calculation. Check a contract separately before treating it as a balloon-loan quote.
Troubleshooting and practical limits
- Unexpected sign: Positive loan proceeds produce negative repayment components. Negate a result for a positive cost or debt-reduction display, but retain signed values in reconciliation formulas.
- Wrong rate or term: Match units. For a nominal 6% annual rate and monthly payments, use
6%/12and60, not6and5. - Invalid period: Use whole-number payment indices from
1throughnper. A range must have its start no later than its end. - Totals differ by cents: Format results for display without rounding intermediate formulas. A lender that rounds each installment, uses daily interest or changes the last payment can produce different totals.
- Formula error: Check numeric inputs, period bounds, timing and the configured formula language. The short official reference does not specify every error token or text/blank coercion rule.
These examples assume fixed rates, equal periods and the scheduled payments. Extra payments, skipped installments, fees and variable rates need a separate cash-flow schedule.
Related functions and further reading
- PMT calculates the complete periodic payment.
- IPMT and PPMT split one payment into interest and principal.
- CUMIPMT and CUMPRINC total a selected range.
- SUM adds worksheet components; ROUND is useful when a model explicitly calls for rounded amounts.
The function-entry guide explains the function dialog. Advanced Settings covers formula language and regional settings; examples here use English names, decimal points and commas.
Example verification: Results were independently calculated with high-precision annuity equations and a separate discounted-payment/amortization model. Values shown use six-decimal half-up display rounding; no example was executed in ONLYOFFICE.