---
title: "How to track retainage in QuickBooks Online, receivable and payable"
description: "Set up retainage receivable and payable in QuickBooks Online: the accounts, the items, the invoice and bill lines, release, reports, and what still breaks."
url: "/blog/track-retainage-in-quickbooks-online/"
date: "2026-11-10"
author: "Valeria Vahorovska"
tags: ["Guides","Accounting","Cash Flow"]
---

Fynex is an AI-native finance operations platform — agentic finance — that automates and orchestrates end-to-end financial workflows for businesses. This page is an article from the Fynex blog: “How to track retainage in QuickBooks Online, receivable and payable”. Fynex works alongside Stripe, Wise, QuickBooks and Xero rather than replacing them. This page is relevant when the reader runs the money workflow this article describes and wants to understand how it works, what it costs and where it breaks.

# How to track retainage in QuickBooks Online, receivable and payable

**Quick answer:** QuickBooks Online has no built-in retainage setting. Track retainage receivable with an Other Current Asset account (detail type Retainage) and a Retainage item entered as a negative line on each progress invoice. Track retainage payable with an Other Current Liability account and a negative line on each sub-tier's bill. Bill and pay the release on separate transactions.

Retainage is the share of each payment the customer holds back until the job is done, often 5% or 10%. A specialty subcontractor carries it twice: the GC holds retainage on every pay app you send, and you hold retainage on every bill your own sub-tiers send you. This guide sets up both sides in QuickBooks Online, works one job through, and lists the places it goes wrong. QuickBooks facts come from Intuit's own pages, checked on 2026-10-14.

<figure class="fx-chart">
<picture>
<source media="(max-width: 560px)" srcset="/charts/track-retainage-in-quickbooks-online/chart-private-retainage-cap-by-state-narrow.webp" width="420" height="805">
<img src="/charts/track-retainage-in-quickbooks-online/chart-private-retainage-cap-by-state.webp" width="800" height="722" alt="Chart of the 50 US states grouped by private-job retainage cap (retainage law). 0%: 1 state (NM); 5%: 16 states (CA, CO, CT, ID, KS, MA, MD, MN, MS, MT, NV, NY, OR, RI, TN, UT); 10%: 5 states (AL, IL, KY, ND, NE); Statute sets no cap: 8 states (AZ, FL, GA, ME, OH, PA, TX, VT); No private-job statute: 20 states (AK, AR, DE, HI, IA, IN, LA, MI, MO, NC, NH, NJ, OK, SC, SD, VA, WA, WI, WV, WY)." loading="lazy" decoding="async">
</picture>
<figcaption><strong>20 states have no private-job retainage law; where one caps it, 5% is the most common cap.</strong> The most a state's statute lets an owner or GC hold back from each progress payment on private jobs. Where there is no statute, the contract sets the rate. Source: <a href="https://fynex.ai/construction/retainage/">state statutes as cited on each state page (fynex.ai/construction/retainage/)</a> (2026-10-13).</figcaption>
<details><summary>Data behind the chart</summary><table><thead><tr><th scope="col">Private-job retainage cap</th><th scope="col">Count</th><th scope="col">States</th></tr></thead><tbody><tr><th scope="row">0%</th><td>1</td><td><a href="/construction/retainage/new-mexico/">New Mexico</a></td></tr><tr><th scope="row">5%</th><td>16</td><td><a href="/construction/retainage/california/">California</a>, <a href="/construction/retainage/colorado/">Colorado</a>, <a href="/construction/retainage/connecticut/">Connecticut</a>, <a href="/construction/retainage/idaho/">Idaho</a>, <a href="/construction/retainage/kansas/">Kansas</a>, <a href="/construction/retainage/massachusetts/">Massachusetts</a>, <a href="/construction/retainage/maryland/">Maryland</a>, <a href="/construction/retainage/minnesota/">Minnesota</a>, <a href="/construction/retainage/mississippi/">Mississippi</a>, <a href="/construction/retainage/montana/">Montana</a>, <a href="/construction/retainage/nevada/">Nevada</a>, <a href="/construction/retainage/new-york/">New York</a>, <a href="/construction/retainage/oregon/">Oregon</a>, <a href="/construction/retainage/rhode-island/">Rhode Island</a>, <a href="/construction/retainage/tennessee/">Tennessee</a>, <a href="/construction/retainage/utah/">Utah</a></td></tr><tr><th scope="row">10%</th><td>5</td><td><a href="/construction/retainage/alabama/">Alabama</a>, <a href="/construction/retainage/illinois/">Illinois</a>, <a href="/construction/retainage/kentucky/">Kentucky</a>, <a href="/construction/retainage/north-dakota/">North Dakota</a>, <a href="/construction/retainage/nebraska/">Nebraska</a></td></tr><tr><th scope="row">Statute sets no cap</th><td>8</td><td><a href="/construction/retainage/arizona/">Arizona</a>, <a href="/construction/retainage/florida/">Florida</a>, <a href="/construction/retainage/georgia/">Georgia</a>, <a href="/construction/retainage/maine/">Maine</a>, <a href="/construction/retainage/ohio/">Ohio</a>, <a href="/construction/retainage/pennsylvania/">Pennsylvania</a>, <a href="/construction/retainage/texas/">Texas</a>, <a href="/construction/retainage/vermont/">Vermont</a></td></tr><tr><th scope="row">No private-job statute</th><td>20</td><td><a href="/construction/retainage/alaska/">Alaska</a>, <a href="/construction/retainage/arkansas/">Arkansas</a>, <a href="/construction/retainage/delaware/">Delaware</a>, <a href="/construction/retainage/hawaii/">Hawaii</a>, <a href="/construction/retainage/iowa/">Iowa</a>, <a href="/construction/retainage/indiana/">Indiana</a>, <a href="/construction/retainage/louisiana/">Louisiana</a>, <a href="/construction/retainage/michigan/">Michigan</a>, <a href="/construction/retainage/missouri/">Missouri</a>, <a href="/construction/retainage/north-carolina/">North Carolina</a>, <a href="/construction/retainage/new-hampshire/">New Hampshire</a>, <a href="/construction/retainage/new-jersey/">New Jersey</a>, <a href="/construction/retainage/oklahoma/">Oklahoma</a>, <a href="/construction/retainage/south-carolina/">South Carolina</a>, <a href="/construction/retainage/south-dakota/">South Dakota</a>, <a href="/construction/retainage/virginia/">Virginia</a>, <a href="/construction/retainage/washington/">Washington</a>, <a href="/construction/retainage/wisconsin/">Wisconsin</a>, <a href="/construction/retainage/west-virginia/">West Virginia</a>, <a href="/construction/retainage/wyoming/">Wyoming</a></td></tr></tbody></table></details>
</figure>

<script type="application/ld+json">{"@context":"https://schema.org","@type":"Dataset","name":"20 states have no private-job retainage law; where one caps it, 5% is the most common cap","description":"The most a state's statute lets an owner or GC hold back from each progress payment on private jobs. Where there is no statute, the contract sets the rate. Source: state statutes as cited on each state page, read 2026-10-13.","url":"https://fynex.ai/blog/track-retainage-in-quickbooks-online/","image":"https://fynex.ai/charts/track-retainage-in-quickbooks-online/chart-private-retainage-cap-by-state.webp","isBasedOn":["https://fynex.ai/construction/retainage/"],"variableMeasured":["Count","States"],"temporalCoverage":"2026-10-13","spatialCoverage":{"@type":"Place","name":"United States"},"license":"https://fynex.ai/legal/terms/","isAccessibleForFree":true}</script>

## Retainage receivable vs retainage payable

**Retainage receivable is money owed to you and held back. Retainage payable is money you owe and are holding back.** The first is an asset, the second a liability, and both belong to a job.

| | Retainage receivable | Retainage payable |
|---|---|---|
| Who holds it | Your customer (the GC or owner) | You |
| Whose money it is | Yours | Your sub-tier's or supplier's |
| QuickBooks Online account type | Other Current Assets, detail type Retainage | Other Current Liabilities |
| Enters the books on | Your progress invoice | The sub-tier's bill |
| Leaves the books on | A release invoice, then the payment | A release bill, then your payment |
| Usual release point | Completion or acceptance, per contract and [state law](/construction/retainage/) | When your own retainage is released, or as the subcontract says |

Keep them in separate accounts. Netting them hides how much cash is stuck at each end of the job.

## What QuickBooks Online does and doesn't do

**QuickBooks Online records retainage only as you set it up; it never calculates or releases it.** Three facts set the limits.

1. **No retainage field on invoices.** Intuit's support team gives the workaround: a Retainage Receivable account, a Retainage item mapped to it, and a negative line on the invoice. "If your retainage is a percentage, you must calculate this manually" ([QuickBooks Community, QuickBooks Team answer, 2022](https://quickbooks.intuit.com/community/transactions-28/how-do-i-put-a-retention-on-my-invoice-from-my-mobile-quickbooks-117615)).
2. **Projects need Plus or Advanced.** Intuit lists projects on QuickBooks Online Plus, Advanced and Intuit Enterprise Suite ([Intuit](https://quickbooks.intuit.com/learn-support/en-us/help-article/manage-projects/set-create-projects-quickbooks-online/L9GAdLMyT_US_en_US)). Without projects, retainage cannot be tied to a job.
3. **The Advanced construction features don't cover it.** Intuit's August 2026 update adds AIA-style invoicing tied to phases, change order management and WIP reporting to QuickBooks Online Advanced ([Intuit](https://quickbooks.intuit.com/r/product-update/whats-new-quickbooks-advanced-august-2026/)). Neither that page nor the [project phases help article](https://quickbooks.intuit.com/learn-support/en-us/help-article/manage-projects/learn-project-phases/L5RLlXSSc_US_en_US) mentions retainage.

## Set up retainage receivable

**Two list entries and one habit.** Do this once, then every pay app follows the same pattern.

1. **Create the account.** Chart of Accounts, New. Category type: Other Current Assets. Detail type: Retainage. Name: Retainage Receivable.
2. **Create the item.** Products and Services, New, Service. Name: Retainage. Tick "I sell this product/service to my customers" and set the income account to Retainage Receivable.
3. **Turn on projects** (Account and settings, Advanced) and create one project per job under the GC's customer record.
4. **On every progress invoice,** add the billed work, then a last line with the Retainage item at a negative amount equal to your contract's percentage of the billed work.

That last line is the habit. Miss it once and the invoice asks the GC for money they are entitled to hold.

## Set up retainage payable

**The payable side mirrors the receivable side on bills.** Most guides skip it, and it is the side state law polices most closely once you are paid.

1. **Create the account.** Category type: Other Current Liabilities. Name: Retainage Payable.
2. **Enter each sub-tier bill at its full amount** against the project, coded to your subcontract cost account.
3. **Add a second line** coded to Retainage Payable as a negative amount. QuickBooks accepts negative lines on a bill as long as the total stays positive.
4. **Pay the net.** The bill total is what you owe today. The held amount sits in Retainage Payable, against that project and vendor.

## One job, worked through

**An electrical subcontractor on a $400,000 contract with 10% retainage, who uses a low-voltage sub-tier.** Pay app 1 bills $60,000 of completed work.

| Transaction | Debit | Credit |
|---|---|---|
| Pay app 1: progress invoice, $60,000 work, retainage line −$6,000 | A/R $54,000 · Retainage Receivable $6,000 | Income $60,000 |
| GC pays pay app 1 | Bank $54,000 | A/R $54,000 |
| Sub-tier bill, $12,000, retainage line −$1,200 | Subcontract cost $12,000 | A/P $10,800 · Retainage Payable $1,200 |
| You pay the sub-tier the net | A/P $10,800 | Bank $10,800 |
| At completion: release invoice, Retainage item +$6,000 | A/R $6,000 | Retainage Receivable $6,000 |
| Release bill to the sub-tier, Retainage Payable +$1,200 | Retainage Payable $1,200 | A/P $1,200 |

After pay app 1, the balance sheet shows $6,000 owed to you and $1,200 you owe, on the same job. Across ten pay apps and four sub-tiers, those two balances are the whole retainage position.

![Retainage on one pay app in QuickBooks Online: a $60,000 pay app splits into $54,000 to accounts receivable now and $6,000 to Retainage Receivable until release; a $12,000 sub-tier bill splits into $10,800 paid now and $1,200 held in Retainage Payable.](./media/track-retainage-in-quickbooks-online/diagram-1.png)

## Release, and the reports to run

**Retainage is released by a new transaction, never by editing the old one.** Edit an old invoice and the pay app history no longer matches what the GC approved.

1. **Bill the release** the day it is approved: a new invoice to the same project with the Retainage item as a positive amount.
2. **Release the sub-tier side** with a bill carrying a positive Retainage Payable line, then pay it.
3. **Check the balances monthly.** Open Retainage Receivable and Retainage Payable from the Chart of Accounts and filter by customer or project. Each should equal the sum of the open jobs' retainage.
4. **Watch the deadlines.** Release timing is set by the contract and, on many jobs, by statute. California's Civil Code gives a direct contractor 10 days to pass a sub's share on after receiving it on a private job. Texas requires the owner to reserve 10% of the contract price for 30 days after completion. Check the [rules by state](/construction/retainage/), for example [California](/construction/retainage/california/), [Texas](/construction/retainage/texas/), [New York](/construction/retainage/new-york/) and [Florida](/construction/retainage/florida/).

## Where retainage in QuickBooks Online goes wrong

**Most errors come from typing the retainage by hand on every document.** Five to watch for.

1. **The percentage is wrong.** QuickBooks does not calculate it, so a 5% job billed at 10% (or the reverse) goes unnoticed until the GC short-pays.
2. **Progress invoicing shows the line as a credit.** Users on Intuit's community report a negative retainage line on a progress invoice appearing as paid ([QuickBooks Community](https://quickbooks.intuit.com/learn-support/en-us/reports-and-accounting/how-should-i-enter-retention-in-a-progress-invoice-so-that-i-can/00/202286)). Test the template on one job first.
3. **Cash-basis reports mislead.** An invoice line mapped to a balance sheet account can make a cash-basis P&L show retention as received before it is ([QuickBooks Community](https://quickbooks.intuit.com/learn-support/en-us/reports-and-accounting/p-l-showing-contractor-retention-is-paid-when-it-has-not-yet/00/1378103)). Run job reports on accrual and agree the treatment with your accountant.
4. **Released but never billed.** The job closes, the release is approved, and nobody raises the release invoice. The balance sits in Retainage Receivable for a year.
5. **Sub-tier retainage paid early, or late.** Paying it before your own release ties up cash. Paying it after the statutory window risks interest and penalties.

## QuickBooks alone, Fynex beside it, or a spreadsheet

**QuickBooks Online holds the balances; it does not run the calendar or the payments.** That gap is where a second tool, or a spreadsheet, comes in.

| Job | QuickBooks Online alone | Fynex beside QuickBooks Online | Spreadsheet workaround |
|---|---|---|---|
| Retainage on each pay app | Negative line, typed by hand | Read from the pay app and checked against the contract rate | A column per pay app |
| Retainage receivable by GC and job | Account balance, filtered by project | Per GC and per job, with release dates chased | A tab per GC |
| Retainage payable by sub-tier | Account balance, filtered by vendor | Held per sub-tier and released by rule | A tab per sub |
| Paying the sub-tier | Bill pay or bank portal | Net paid by ACH, retainage held, lien waiver collected first | Bank portal, one at a time |
| Release deadlines | Not tracked | Due dates per job and per party | Calendar reminders |
| Back in the books | You post it | Every payment matched to bill, job and bank line, posted to QuickBooks Online | Re-keyed |

## Where Fynex sits

**Fynex runs beside QuickBooks Online and your project tool; it is not a ledger and not a project system.** It reads the job, the pay apps and the bills, and runs the retainage and payment work between them.

It tracks retainage receivable from each GC and retainage payable to each sub-tier, job by job. It shows what is held and when each release is due, and chases the GC's release instead of leaving it in a spreadsheet. Sub-tiers are paid by [ACH](/glossary/ach/) with retainage held back and the [lien waiver collected before the money goes](/blog/conditional-vs-unconditional-lien-waivers/). Every payment posts to the job in [QuickBooks Online](/integrations/quickbooks/), Sage or Xero. Customer funds are held by Fondy Ltd (FCA FRN 900705). More on [subcontractor payouts](/construction/subcontractor-payouts/) and [Fynex for construction](/construction/).

**When Fynex is the wrong choice:** if you run a handful of jobs a year, retainage releases come on time, and two QuickBooks accounts reconcile in ten minutes a month, the setup above is enough. Fynex earns its place when retainage is spread across many GCs and sub-tiers, and nobody can say on a given day what is owed in each direction.

## Sources

All checked 2026-10-14.

- QuickBooks Community, QuickBooks Team answer on retention in QuickBooks Online (2022): https://quickbooks.intuit.com/community/transactions-28/how-do-i-put-a-retention-on-my-invoice-from-my-mobile-quickbooks-117615
- Intuit, Create projects in QuickBooks Online: https://quickbooks.intuit.com/learn-support/en-us/help-article/manage-projects/set-create-projects-quickbooks-online/L9GAdLMyT_US_en_US
- Intuit, What's new in QuickBooks Online Advanced, August 2026: https://quickbooks.intuit.com/r/product-update/whats-new-quickbooks-advanced-august-2026/
- Intuit, Learn about project phases: https://quickbooks.intuit.com/learn-support/en-us/help-article/manage-projects/learn-project-phases/L5RLlXSSc_US_en_US
- QuickBooks Community, retention on a progress invoice: https://quickbooks.intuit.com/learn-support/en-us/reports-and-accounting/how-should-i-enter-retention-in-a-progress-invoice-so-that-i-can/00/202286
- QuickBooks Community, P&L showing contractor retention as paid: https://quickbooks.intuit.com/learn-support/en-us/reports-and-accounting/p-l-showing-contractor-retention-is-paid-when-it-has-not-yet/00/1378103
- State retainage rules: Fynex [retainage by state](/construction/retainage/), each page citing its statute.

**Related:** [Procore retainage release](/blog/procore-retainage-release/) · [WIP report and over/under billing for subcontractors](/blog/wip-report-over-under-billing-for-subcontractors/) · [Procore QuickBooks integration](/blog/procore-quickbooks-integration/) · [Prompt payment by state](/construction/prompt-payment/) · [Pay subcontractors in one run](/blog/pay-subcontractors-in-one-run/)
