Skip to main content
Procore (en-CA)

Set or Release Retainage on a Subcontractor Invoice


To set or release retainage for line items on a subcontractor invoice with the Invoicing tool. 


In Procore, the term Retainage refers to the practice of withholding of a portion of a contract amount until the work is deemed satisfactorily complete. The withheld amount is specified in an agreement between the contracting party (the party paying for the work) and a contracted party (the person or company performing the work).  A common practice is to withhold 5-10% of a contract's total value until a milestone is reached. Then, the withheld amount can be released as a progress payment. When work is substantially complete, the withheld amount can be released as a final payment. 

Things to Consider

  • Required User Permission:
    • To edit an invoice before/during/after the current billing period,  'Admin' on the Commitments tool
    • To edit an invoice, during the current billing period only, 'Standard' on the Commitments tool. 
      • A member of the 'Private' drop-down list on the commitment.
        Note: Members of the 'Private' list are automatically added as an 'Invoice Contact' on the commitment. See Create Invoice Contacts.
        Your ability to perform certain tasks with the Invoicing tool depends on the access permission you've been granted to the Prime Contracts or Commitments tool, as well as the privacy and invoice contact settings set on each prime contract or commitment that you are working with. To learn more about permissions for specific tasks that can be performed with the Invoicing tool, see Permissions: Invoicing.
  • Prerequisites:
  • Additional Information:
    • To set the same percentage of retainage on all line items in the invoice, enter a value to apply to all line items in the invoice.
    • To release retainage on all line items, enter a value  to apply to all line items. This move the desired percentage from the 'Currently Retained' column to the 'Released This Period' column.
    • For customers in Australia flag-australia.png, you can also manage withholding using the sliding scale retention feature. To learn more, see What is sliding scale retention?


  1. Navigate to the project's Invoicing tool.
  2. Click the Subcontractor tab. 
  3. Locate the commitment that you want to work with and click its link in the Commitment column. 
  4. Click the Invoices tab. 
  5. Locate the invoice to work with and click Edit
  6. Click the Detail tab in the invoice.
  7. Click the Edit button. 
  8. Choose one of the following:

Set Retainage on All Line Items

  1. Under Set Retainage on All Line Items, do the following:
  2. Enter the percentage to withhold in the Work Completed box. 
  3. Click Set.
  4. Enter the percentage to withhold in the Materials Stored box. To learn more, see How do I bill for stored materials in Procore?
  5. Click Set.

Release Retainage on All Line Items

  1. Under Release Retainage on All Line Items,  do the following:
  2. Enter the percentage to release in the Work Completed box. 
  3. Click Release