DocsHead contractorThe retention you hold

The retention you hold

Retention held, the ledger of what you have withheld from each subcontractor on the schedules you issued, what you have released, and exporting it to CSV.

  • Reviewed 20 Nov 2026
  • 3 min read
  • Head contractor

Retention held lists every subcontract your company is the head contractor on, with the retention you are holding on each. Open it from the sidebar, under Overview, or from the Retention held figure on your overview. The two show the same total.

A subcontract set up with no retention is not listed: nothing is withheld on it, so there is nothing to hold or release.

What counts as held

Only retention on a payment schedule you have issued counts. A schedule you are still preparing adds nothing until you issue it. Retention a subcontractor has claimed on a claim you have not answered yet is not held either: it shows under the withheld figure as claimed, not yet certified, so you can see what is coming.

Archiving a subcontract does not take it off the ledger, because you still hold its retention. Its row stays, with the same figures, and is marked Archived with the day you archived it.

The columns

ColumnWhat it shows
WithheldRetention withheld to date on the schedules you issued.
ReleasedRetention released to date on the schedules you issued.
Net heldWhat you still hold: withheld, less released, less anything written off.
Against the capRetention withheld against the subcontract's retention limit, with the limit beneath. Releasing retention does not free up room under the limit, so this is withheld rather than held. Anything above it is shown in red.
Trigger metWhether the subcontract has reached the point its retention terms set for a release, and how far towards it it is.
Available to releaseWhat the subcontractor could ask for back on its next claim, under the contract's release terms.
Defects periodWhether the subcontract is before practical completion, in its defects period, or past it, and when that period ends.

The four figures above the ledger are its totals. Net held also says how many of your subcontracts are holding anything.

When it falls due back

The chart under the totals shows when the retention you hold falls due back, month by month over the next year, with anything after that in one Later bar. The bars add up to Net held, unless a subcontract has had more released than you withheld from it: nothing is due back on that one, so the chart leaves it out and Net held is lower by the difference. Each subcontract's first share is due once it reaches its release point (now, if it already has) or otherwise at practical completion, and the rest when its defects period ends. Retention already past its date shows in the current month.

It is worked out from the dates recorded on each subcontract, so it is a forecast rather than a promise: a job that finishes late releases late. It narrows with the project filter like everything else on the page.

Narrowing to one project

Choose a project from the filter under the heading. The ledger and every total narrow to the subcontracts on that project straight away, and Clear shows them all again. A subcontract on no project appears only under All projects.

Exporting to CSV

Export CSV downloads the rows on screen, for the project you have chosen. Each figure is a plain number with two decimal places, so a spreadsheet can add the columns up. The file also carries the written-off amount and the claimed-but-not-certified retention, so the columns reconcile.

The columns are always in this order, named the way the Register's export names its own:

subcontractor,contract_id,contract,project,currency,withheld,claimed_not_yet_certified,released,written_off,net_held,retention_cap,withheld_against_cap,withheld_above_cap_by,trigger_met,release_trigger_percent_certified,available_to_release,defects_period,defects_period_ends,archived

contract_id is the subcontract's own reference, as it shows on the contract. archived is the day you archived the subcontract, and is empty while it is live.

Was this page useful?Something wrong? Contact support