Skip to main content

Create a Subcontractor Invoice for Release of Retainage in the Invoicing Tool


To create a subcontractor invoice for the release of retainage as a final payment.


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 Permissions:
    • To set and release retainage when editing the most recent invoice before, during, or after the billing period's 'Due Date':
    • To release retainage when editing the most recent invoice during the current billing period:
      • You must have 'Standard' level permissions on the Project level Commitments tool. 
      • You must be added to the 'Private' drop-down list on the commitment. 
    • Read about required user permissions for downstream collaborators: Show/Hide  
      • Some Procore customers choose to provide their downstream collaborators with access to the Project level Commitments tool:
        • To modify retainage amounts on the most recent invoice before the billing period's 'Due Date':
          • You must be an invoice contact on the commitment.   
          • You must have 'Read Only' level permissions on the Project level Commitments tool. 
  • Additional Information:
    • If there are multiple invoices for a single billing period, you can only edit the billed amounts on the most recent invoice.
    • If you are adding a payment schedule after the invoice is approved, enter the amount for the work you are claiming this period in the 'Proposed Amount' column of the invoice detail. To learn more, see Create a Payment Schedule
    • You can also manage withholding using the sliding scale retention feature. To learn more, see What is sliding scale retention?
    • To learn how to create an invoice to release retainage on a progress billing, see Set or Release Retainage on a Subcontractor Invoice.


  1. Navigate to the project's Invoicing tool. 
  2. Click the Subcontractor tab.
  3. Locate the subcontractor invoice to update in the table. Then click its Invoice # link to open it.
    This opens the invoice in the project's Commitments tool. 
    • When navigating to an invoice from the Invoicing tool, your user account must be granted the required user permissions detailed above in order to view and gain access to the invoice.
  4. In the invoice, click the General tab. The General tab is active by default when you open an invoice.  
  5. Scroll down to Schedule of Values
  6. Optional: If the contractor will create a payment schedule once the invoice is approved, enter the amounts for the work you are claiming this period in the 'Proposed Amount' column.
    Note: In order for the 'Proposed Amount' column to appear, the payment schedule feature must be enabled in the Invoicing tool’s configuration settings. See Configure Settings: Invoicing.
  7. Click Save.
  8. Optional. If the invoice administrator requires you to include a signed copy of the PDF, complete the following steps:
    1. Choose Export > PDF.
    2. Sign the PDF.

      How do you add a signature to a PDF? Depending on your specific business requirements, there are different options you can evaluate to determine the best option for you:

      • Wet Signature. You can print out the exported PDF file and add a physical signature. Then use a scanner or camera to capture the signed document and add it to your invoice an attachment. 
      • Electronic Signature. You can add a digital or electronic signature to the invoice. There are a variety of third-party software vendors, such as DocuSign© and Adobe® Acrobat™, that provide signature capabilities for PDF files. After you sign the document, add it to your invoice as an attachment. 
  9. Click the Summary tab.
  10. Click Edit.
  11. In the Attachments section, upload any required backup documentation, such as lien waivers and the signed export PDF.
  12. Choose from the following options:
    • If you are ready to submit the invoice to the contractor, click Submit for Review. This changes the invoice status to Under Review
    • If you are NOT ready to submit the invoice, click Save. This sets the invoice status to Draft.
      Note: Once you submit the invoice to the contractor, you will no longer be able to edit it unless the contractor changes the status Revise & Resubmit.