Skip to main content
Procore

Modernised main contract payment application transition guide

Overview

The modernised main contract payment application experience offers a redesigned payment application interface, expanded Bill of Quantities (BOQ) detail, group or subtotal row billing, configurable fieldsets and custom fields and the ability to include approved budget changes directly on a main contract payment application.

The key benefits of the modernised main contract payment application experience include:

  • Budget changes on payment applications. Include approved budget changes directly on a main contract payment application for greater contingency transparency, reducing the need for separate main contract variations.

  • Selective cost prefill. Hand-select which subcontractor payment application and direct cost line items prefill onto a main contract payment application, split costs across multiple payment applications and mark costs as non-billable.

  • Group row billing. Bill a fixed pound amount at the group level and let Procore proportionately distribute it across the group's line items, instead of editing each line item one at a time.

  • Bulk line items updates. Select any or all Bill of Quantities line items and use the Edit values side panel to set Work completed this period (%), Total to date (%) and retention percentages across every selected line at once.

  • Configurable fieldsets and custom fields. Customise the fields visible on your organisation's main contract payment applications.

  • Expanded bill of quantities. Full screen view and additional columns including gross amount, net amount and previous/current changes provides you a fuller picture of the period. 

  • Attachment ordering. Drag and drop to reorder or arrow up and down groups of PDF attachments before exporting.

  • Legacy & customised PDF export preserved. Generate the original legacy or custom solutions generated-format payment application PDF.

  • Workflows support. Main contract payment applications support Procore Workflows, including continued use of your existing legacy (V1) workflows. For more information, see For customers using legacy (V1) workflows.

Things to Know

 Important
  1. Procore will discontinue the legacy main contract payment application experience on 12 January 2027. After that date, the legacy main contract payment application interface will no longer be available.

  2. Change in behaviour: Payment application amounts lock during review and approval

    1. To support workflow controls and ensure payment application amounts, the Bill of Quantities cannot be edited while a payment application is Under review or in an approved status.

    2. Administrators can still edit the general information, attachments and custom fields while payment applications are in these statuses.

    3. If bill of quantities amounts need to change, the payment application must be returned to an editable status first.

There are two ways to opt in, depending on the scope you need:

  1. Individual opt-in. Eligible user can switch to the modernised experience using the opt-in banner on an existing payment application. This opts in only that user — no administrator involvement is required.

  2. Project or company opt-in. A Procore administrator enables the modernised experience for an entire project or company through Procore Explore. This applies to everyone on those projects. In Procore Explore search for Remove Legacy commitment/Subcontractor Payment Applications Access.

Because individual opt-in is per-user, a project can have some users on the modernised experience and others on legacy at the same time. For more information, see Considerations and Transition steps section.

For customers using legacy (V1) workflows

As of 13 October 2026, you will no longer need to migrate off legacy (V1) workflows before adopting modernised main contract payment application. This is a change from prior guidance.

  • Legacy workflows keep running. Nothing about how a legacy workflow behaves changes: the same steps, approvers, routing, conditions and history still apply. What changes is where you manage them. Legacy workflow items now open and are responded to in the same New Workflows side panel used for New Workflows.

  • In-flight work is not interrupted. Payment applications mid-approval when you adopt the modernised experience remain active, accessible and retain their history. You do not need to abandon, recreate or re-approve work already in progress.

  • Upgrading to new workflows is self-service and optional. Also releasing on 13 October 2026, a new self-service upgrade option allows workflow admin to transition from legacy workflows to new workflows on their own timeline, without contacting Procore support. For more information, see Transition path for customers using legacy (V1) workflows.

  • Availability: As of 13 October 2026, legacy workflow capabilities are generally available across Procore, with main contract payment application as the first adopting tool. 

Considerations

  • You can switch to the modernised main contract payment application experience at any time. On 12 January 2027, all remaining legacy users will be updated automatically.

  • No action is required prior to the migration date. If you do not opt in early, your account will migrate automatically on 12 January 2027.

  • After the migration date, the legacy main contract payment application experience will be permanently retired and unavailable.

  • Budget change prerequisite. Including budget change on main contract payment applications requires opting into the modernised main contract payment application experience and migrating to the new budget change tool. If you have not migrated to the new tool, you can still use the modernised experience, but budget change integration will be unavailable.

  • Legacy PDF output is preserved. If your team or project owner relies on the legacy payment application PDF format (or a custom version created by Procore’s custom Solutions team), you can still generate it from the modernised experience. Simply select the Historical Standard Payment Applications PDF export option. You do not need to remain on the legacy interface to produce legacy-formatted PDFs.

Comparison

The following matrix details key feature enhancements and benefits of transitioning from legacy to modernised main contract payment application:

Feature
Legacy main contract payment application
Modernised main contract payment application

Primary design layout

A fixed table layout with limited on-screen detail.

A modernised layout consistent with Procore's other financial tools, surfacing key payment application detail inline.

Bill of Quantities

Core billing columns only.

Adds gross amount, net amount and previous/current changes columns. New payment applications mirror the row groupings from the previous payment application.

Budget changes

Not available on payment applications; contingency movement required separate main contract variations.

Approved budget changes can be included directly on the payment application. (Requires migration to the new budget change tool.)

Cost prefill

Cost prefill for the valuation period with limited control.

Hand-select which subcontractor payment application and direct cost line items prefill, split costs across multiple payment applications and mark costs non-billable.

Custom fields & fieldsets

Not configurable.

Configurable fieldsets and custom fields on main contract payment applications.

Attachments

Fixed attachment order.

Drag-and-drop individual and arrow up/down group attachment reordering before export. Multiple attachment sections for prefilled items. 

PDF export

Legacy payment application and configurable PDF format.

Multiple export formats, including the Historical Standard PDF export that reproduces the original legacy format and any customised PDF.

Workflows

Legacy (V1) workflows only, actioned on a separate workflow screen.

Support new workflows and legacy (V1) workflows, both actioned in the new workflows side panel.

Transition Steps

 Important
No manual steps are required, as all accounts will update automatically on 12 January 2027. However, Procore recommends testing the modernised experience on a sample test project first, then switching your entire company over whenever you are ready.

There are two ways to opt in and they differ in both scope and eligibility. Choose based on who needs access and check the eligibility note on Option 1 first.

  1. Option 1: Opt in as an individual user (evaluation)

  2. Option 2: Opt in an entire project or company (rollout)

Option 1: Opt in as an individual user (evaluation)

Available to users whose project Payment Applications tool uses new workflows or no workflows. If your Payment Applications tool uses legacy (V1) workflows, the opt-in banner will not appear. Beginning 13 October 2026, the banner will also become available for legacy workflow users. Until then, use Option 2. For details, see the Transition path for customers using legacy (V1) workflows.

Any eligible user with access to main contract payment applications can opt themselves in directly from a payment application — no administrator involvement required.

  1. Open the Main Contracts tool from the project tools drop-down menu and open a main contract.

  2. Open an existing main contract payment application.

  3. In the beta opt-in banner at the top of the payment application, click to switch to the modernised experience.

What this does and does not do:

  • This opts in only you. Other team members will remain on the legacy experience until they opt in or an administrator enables the feature for the project or company.

  • It is the fastest way to evaluate the modernised experience and the right first step before committing a project to it.

Option 2: Opt in an entire project or company (rollout)

To enable the modernised experience for everyone on a project or across your company, a Procore administrator can turn it on through Procore Explore. This option is available to all customers, including those using legacy (V1) workflows—and until 13 October 2026, it is the only route available for those workflows.

  1. Navigate to the Company level Admin tool.

  2. Click Procore Explore.

  3. In the Procore Explore catalogue, scroll or search for Remove legacy main contract payment application/fundng access.

  4. Select the specific project(s) or user(s) where you want to activate the modernised experience and select Save & Join.

    • Note: You can also enable the modernised experience at the Company level - for all projects - through Procore Explore. 

  5. Confirm that the modernised experience is active for the project or user:

    • The payment application detail page uses the modernised financial tools layout.

    • A Work completed: this period (£) field is editable on group subtotal rows.

    • Selecting line item tickboxes on the Bill of Quantities surfaces an Edit values button.

  6. Configure the modernised experience for your payment application:

    • Review your BOQ grouping options — create, edit or delete custom groups via Manage custom groups and confirm the groupings your team will bill against.

    • Configure fieldsets and custom fields for main contract payment applications.

    • Review your export formats and confirm the legacy main contract payment application PDF export meets any external reporting requirements.

  7. Create a test main contract payment application on your sample project to validate the modernised experience end-to-end including prefill, BOQ, group row billing, bulk editing line item values and exporting before enabling the modernised experience company-wide.

Transition path for customers using legacy (V1) workflows

Recommendation

Evaluate the modernised experience today on sample projects, but delay company-wide rollout until 13 October 2026. Legacy (V1) workflows will not support the modernised experience until 13 October 2026.

You can opt in early, but doing so before 13 October will prevent payment applications from routing through your existing legacy approval workflows.

What "Evaluate" and "Fully transition" mean

 

Evaluate (safe to do now)

Fully transition (wait until 13 October 2026)

Purpose

Get familiar with the modernised experience and confirm it meets your needs.

Run your live billing cycles in the modernised experience.

Where

A dedicated test project.

Production projects.

What you exercise

Layout, Bill of Quantities, group row billing, bulk Edit Values updates, cost prefill, budget changes, custom fields, exports.

All of the above, plus payment application approvals routed through your legacy workflows.

Approvals

Do not rely on legacy workflow approvals during this period.

Legacy workflow approvals are supported in the modernised experience.

Timeline

Date

What changes for legacy (V1) workflow customers

Today

Evaluate the modernised experience on a test project via Procore Explore. The individual opt-in banner does not appear for you. Legacy workflows cannot be used with the modernised experience, so hold off on transitioning production projects.

13 October 2026

Legacy workflows become usable with the modernised experience and the individual opt-in banner becomes available to you. You can begin fully transitioning production projects and start and respond to legacy workflow items in the New workflows side panel.

Phase 1 — Evaluate now (before 13 October 2026)

  1. Identify or create a test project that is not running live billing.

  2. Enable the modernised main contract payment application experience on that test project through Procore Explore, following the steps in Option 2 above.

  3. Create test main contract payment applications to validate the full feature set—including the Bill of Quantities (BOQ), group row billing, bulk Edit Values updates, cost prefill, budget changes, custom fields and payment application exports.

 Note
Identify any process gaps during testing and contact your Procore representative well before your planned transition date.
 Important
Do not enable the modernised experience on live production projects during this evaluation phase. Additionally, do not rely on legacy workflow approvals while testing.

Phase 2 — Transition (13 October 2026 or later)

  1. Confirm that legacy workflow support is live in the modernised experience within your environment.

  2. Enable the modernised main contract payment application experience on a production project through Procore Explore. As of this date, individual users can also opt in directly using the banner at the top of a payment application.

  3. Run a complete billing cycle on that project including routing payment application approvals through your existing legacy workflows and exporting the final document to verify end-to-end functionality.

  4. Confirm that legacy workflow items start and respond correctly in the New workflows side panel.

  5. Once that billing cycle completes successfully, proceed to enable the modernised experience on your remaining projects or across your entire company.

 Note
Individual banner opt-in does not allow for end-to-end approval testing. Because it applies only to your account, approvers may still see the legacy experience. To validate approval behaviour before a full rollout, enable a Project level opt-in through Procore Explore so all approvers share the same experience.