Retainage in QuickBooks Online for custom home builders: held from you and held from your subs
How to record retainage receivable and retainage payable by house, release it with a new transaction and keep both balances tied out.
Short answer: QuickBooks Online has no retainage setting, so builders use two balance sheet accounts. Retainage Receivable, an asset, holds what a client withholds from your invoice. Retainage Payable, a liability, holds what you withhold from a sub's bill. Each is a negative line tagged to the house, and each is released later by a new transaction, never by editing the old one.
How do you track retainage in QuickBooks Online?
QuickBooks Online has no retainage setting. Use a Retainage Receivable asset account for what a client holds from you and a Retainage Payable liability account for what you hold from subs. Enter each hold as a negative line tagged to the house, release it with a new transaction, and tie both accounts out by house every month.
| Direction | Account | Account type | At hold | At release |
|---|---|---|---|---|
| Client holds from you | Retainage Receivable | Other current asset | Negative line on the progress invoice | Positive line on a release invoice |
| You hold from a sub | Retainage Payable | Other current liability | Negative line on the sub bill | A payment that clears the liability |
| Monthly tie-out | Each account by house | Both | Held to date by house | Released to date by house |
Two balances, two directions
Retainage is a share of a payment that is held back until a later milestone. On a home, it can run in two directions at the same time. A client, or the client's lender, may hold part of each of your draw invoices. You may hold part of each sub's bill until their work is accepted. Our retainage and customer deposits guide explains the concept. This guide is the QuickBooks Online setup.
Keep the two balances apart. One is money you are owed and cannot collect yet. The other is money you owe and have not paid yet. Netting them hides how much cash is stuck at each end of a house.
What QuickBooks Online does not do
QuickBooks Online has no retainage field on invoices or bills. Intuit's own community answers describe a workaround: an account for the held amount, an item or line that points at it, and a negative amount on each transaction. Levelset's guide adds that QuickBooks does not calculate the percentage, so someone types it on every invoice. Intuit's current pages also list "Retainage AR & AP" among Intuit Enterprise Suite features that are in beta, so check what your plan shows before you build the workaround. Our QuickBooks Online Advanced construction guide covers what Intuit says each plan includes.
Want retainage tracked on both sides? Request a Relationship Assessment.
When retainage is held from you
On a custom home, a client's lender often funds each draw less a holdback. One industry source, BuilderGrid, says 10 percent is usual on residential construction loans and that some lenders step it down to 5 percent after the home is half complete. Your contract and loan documents decide the real number, so read them before the first draw.
- Create the account. In the chart of accounts, add Retainage Receivable as Other Current Assets, with Retainage as the detail type.
- Create the item. In Products and services, add a service called Retainage. Mark it as sold to customers and set its income account to Retainage Receivable.
- Bill the full draw. On each draw invoice, bill the work, then add the Retainage item on its own line as a negative amount. Tag every line to the house's project or customer.
- Release it later. When the contract or lender says it is due, create a new invoice with the Retainage item as a positive amount. That moves the balance from Retainage Receivable into accounts receivable.
Example, with made-up numbers: a $100,000 draw with 10 percent held back is a $90,000 invoice. The other $10,000 sits in Retainage Receivable on that house until release.
A spec home is different. In our experience the builder is the borrower, so a lender holdback is usually loan money not yet funded, not a receivable, and nothing is recorded until the lender releases the funds. Ask your CPA how to treat it.
When you hold retainage from subs
- Create the account. Add Retainage Payable as Other Current Liabilities. Intuit's community answer for this setup stops there and refers the rest to your accountant, so confirm the treatment with yours.
- Enter the bill gross. Record the sub's full bill, coded to the cost account or product and service for that trade, with the house in Customer/Project.
- Add the held amount. Add a second line coded to Retainage Payable as a negative amount, tagged to the same house. Aequo AP's walkthrough describes this pattern. The bill total becomes the net you pay now, and the full cost stays on the house.
- Release it later. Enter a new bill with one positive Retainage Payable line and pay it. Do not code the release to a cost account, because the cost was already recorded.
Example, with made-up numbers: a $40,000 framing bill with 10 percent held is a $36,000 bill. The house shows $40,000 of framing cost, and $4,000 waits in Retainage Payable.
A cash-basis warning
An Intuit Community thread from November 2024 describes a cash-basis builder whose profit and loss showed the full $10,000 invoice as income after the customer paid only $9,000, because the retainage item points at a balance sheet account. A reply there said there is no perfect fix and that each option has drawbacks. If you run cash-basis reports, agree the treatment with your CPA, and run job reports on accrual.
Who may hold what, and when
Rules about how much can be held, when it must be released and whether money held for subs must be kept separate vary by state. BuilderGrid, for example, says some states treat retainage held from subs as trust funds and that some restrict mirroring the lender's rate onto residential subs. We do not give legal advice. Have your attorney confirm your state and your subcontract wording before you rely on any of this.
Monthly checks
- Run the Retainage Receivable and Retainage Payable accounts by house. Each house's balance should match the draw and bill math.
- Compare the percentage on every invoice and bill to the contract, since QuickBooks will not catch a typo.
- List releases that are due. A released balance that nobody invoiced can sit for months.
- Confirm each house's retainage lines appear on the job cost report and tie to your WIP schedule.
- Match lender holdbacks to the draw package before you submit it.
How we help
Our team sets up both accounts, records retainage on every invoice and bill, tracks each release and ties the balances out by house at every close. Our founder reviews every close. We quote a flat monthly price for each builder, starting at $1,500 a month, with typical engagements between $2,500 and $8,500 a month. Start with a $1,500 Margin Review for written findings. See job costing, construction bookkeeping, our pillar guide on how to job cost a custom home, pricing or request a Relationship Assessment.
Sources
- AIA Contract Documents, Retainage in construction: how to bill and release
- Sage Construction Management Help, Track retainage in QuickBooks Online (retention accounts and service item)
- Intuit Community, How do I enter retainage on an invoice (QuickBooks Team answer, Sep 2024)
- Intuit Community, How do I set up a retainage payable account
- Intuit Community, Retainage on the balance sheet but P&L income overstated (cash basis, Nov 2024)
- Levelset, Recording and tracking retainage receivable in QuickBooks
- Aequo AP, How to track retainage in QuickBooks Online (subcontractor bills)
- BuilderGrid, Retainage on residential builds: how holdbacks work and release
- Intuit, QuickBooks Online Advanced for construction (Intuit Enterprise Suite features in beta)
Common questions
Does QuickBooks Online have a retainage setting?
Not on invoices or bills. Intuit's community answers use a balance sheet account plus a negative line, and Intuit lists retainage AR and AP among Intuit Enterprise Suite features in beta. Check what your own plan shows.
What account type is retainage receivable?
Other Current Assets, with Retainage as the detail type. Retainage payable is a separate Other Current Liabilities account.
How do I release retainage in QuickBooks Online?
Create a new transaction. For receivable, an invoice with the Retainage item as a positive amount. For payable, a bill with a positive Retainage Payable line. Do not edit the original.
Should retainage be tagged to the house?
Yes. Tag every retainage line to the house's project or customer so each house shows what is held and what is owed.
Is a spec home lender holdback retainage receivable?
Usually not. On a spec home the builder is the borrower, so a holdback is typically loan money not yet funded. Ask your CPA how to record it.
Can you track retainage for our houses every month?
Yes. Our team records retainage on each invoice and bill, tracks releases and ties both balances out by house at every close.
How do you track retainage in QuickBooks Online?
QuickBooks Online has no retainage setting. Use a Retainage Receivable asset account for what a client holds from you and a Retainage Payable liability account for what you hold from subs. Enter each hold as a negative line tagged to the house, release it with a new transaction, and tie both accounts out by house every month.
Related
- Retainage, deposits and customer deposit accounting
- Construction draw package checklist
- How to job cost a custom home
- Month-end close checklist for builders
- QuickBooks Online Advanced construction features for home builders
- Job costing
- Glossary: Retainage
- Glossary: Retainage payable
- Request a Relationship Assessment
- Subcontractor pay application review checklist
By John Mos, Founder. Updated . We do not give tax or legal advice. Please ask your CPA or attorney.
See where your margin goes, house by house.
Tell us about your homes and your books. If we are a fit, we start with a $1,500 Margin Review: written findings and a fixed quote in 10 business days, credited to your onboarding fee if you sign up.