Budget Settings

Project administrators can access the settings for Cost Management from Settings tool in the left navigation. This article focuses on the Budget settings:

Budget Code Format

Create your budget code format by following the guidelines in the Budget Code Setup article. Define the budget code segments before importing a budget into Cost Management.

See the Budget Code Setup article to learn how to:

Budget Name Format

Select one or more budget segment descriptions as the default name of new budgets.

When you rename budget segments, delete them, or change the order in the Budget Code Segments setting, the default names will also change.

Budget Overview Columns

Project administrators can manage the name, group, and order of existing columns. They can also create custom columns based on project values or other columns.

To manage existing columns and create custom calculated budget columns, click Manage.

To change where existing columns appear (group and position), rename them and control which appear by default. Select the column name and choose the desired option beneath the list view.

Budget overview columns management interface showing column configuration options

To learn more about managing custom columns, see the Create Custom Columns article.

Fee Analysis

Set up fee categories and their data sources for analysis in the Budget view. Each fee category points to budget columns that supply the original and forecasted fee values, and the Fee Analysis table calculates variance, ratios, and percentage of the main contract from those values.

Fee analysis settings page with the Setup Guide and a configured table of fee categories mapping Original Fee and Forecasted Fee to budget columns

To set up Fee Analysis:

  1. Open project Settings, then the Budget tab.
  2. Expand the Fee analysis section and click Manage.
  3. Add a row for each fee category you want to analyze (for example, Base Fee, Shared Savings, Billed Rates). For each row, set:
    • Name — Required. Display name used in the Fee Analysis table.
    • Original Fee — The budget column that supplies the original fee value, or a fixed number.
    • Forecasted Fee — The budget column that supplies the forecasted fee value, or a fixed number.
  4. Save your changes.

The remaining columns — Original Main Contract %, Final Main Contract %, Fee Variance, and Variance Ratio — are calculated automatically from the Original Fee and Forecasted Fee values. Fee Goal defaults to the Forecasted Fee value but can be edited manually in the Budget view, and Notes is a free-text field also editable in the Budget view.

To deactivate or delete a fee category, use the 3-dot menu next to each row.

Note:

  • Original Fee and Forecasted Fee can reference any budget column whose total is calculated by summing all rows. Custom columns must already exist in the project before you can pick them here. See Create Custom Columns for setup.
  • Fee analysis values are project-level totals and ignore filters applied to the Budget view.

See Fee Analysis and Fee Analysis Snapshot for how project members consume these settings in the Budget view.

Budget Financial Markup Formulas

Define markup formulas that calculate values on the Final Main Contract Amount column in the Budget view. When a formula is applied, the affected budgets become markup budgets, and their Final Main Contract Amount values come from the formula calculation instead of the column's defined formula.

Budget financial markup formulas section expanded with an Add button and a list of saved formulas

Note: Budget financial markup formulas apply to budget columns and are configured here. They are a separate concept from the Financial Markup Formulas configured on the Change Order tab and applied to change orders. Both can coexist on the same project.

To create a budget financial markup formula:

  1. Open project Settings, then the Budget tab.
  2. Expand the Budget financial markup formulas section and click Add. The formula editor opens.
  3. Set the formula's name and an optional description (the pencil icons next to the title and subtitle).
  4. Build the formula by dragging items from the Drag and drop to add formula item panel on the left into the formula table. Two item types are available:
    • Markup — A markup row. After dropping it, click the row to open the Markup edit panel on the right and configure:
      • Name (required).
      • Type & ratePercentage (calculated against the selected Cost Basis) or Lump sum.
      • Cost Basis — The basis used to calculate this markup, such as Current cost basis or a previous subtotal.
      • Variable — Toggle on to allow the markup amount to be edited at the time the formula is applied.
      • Description (optional).
      • Map markup to budget code (required) — The budget code in the project that this markup writes to. Each markup must map to a unique budget code. If the code doesn't exist when the formula is applied, a new budget is created using the markup name, with Original Budget set to Qty 1, Unit Cost 0, Amount 0.
      • Calculated on non-markup budgets where — Optional filter that scopes which budgets this markup calculates against, based on the value of the column where the formula is applied or on budget code segments.
    • Subtotal — A subtotal row. After dropping it, click the row to open the Subtotal edit panel on the right and configure:
      • Markup subtotal name (required).
      • Cost basis revisingRevise cost basis recalculates the Cost Basis used by markups that follow this subtotal. Info only displays the subtotal without changing the cost basis for subsequent markups.
  5. Reorder, rename, or remove markup and subtotal rows as needed. The system fills in the Amount column for each markup, and Markup total and Grand total are calculated at the bottom of the formula.
  6. Click Save.

Budget financial markup formula detail with a drag-and-drop palette and a table of markup items showing Rate, Base, and Amount

Manage saved formulas:

To manage saved formulas, open the 3-dot menu on the formula row in the list:

Note: If the master list is locked and a mapped budget code can't be created when the formula is applied, members can't apply the formula.

Project copy and templates:

See Apply Markup Formula on Budget Columns for how project members apply, recalculate, and clear formulas in the Budget view.

Budget Lock

Once the original budget setup is finalized, select the Lock Budget button to lock it.

Important: Only hub administrators can fully lock the budget. Project administrators can set the budget to 'Original budget locked,' but they can't change the lock once it is set.

After a budget is locked, the quantities, units, unit costs, and ratios of the forecast are also locked. However, with the Forecast tab, you can still:

Tip: As a hub administrator, you can also lock the budget with integration. See the Lock Fields and Actions with an Integrated ERP System article to learn what else can be locked and how it affects Cost Management's workflows.

Internal Budget Transfer

Enable this setting to allow team members to perform internal budget transfers from the budget summary view.

Toggle on Approval Workflow to create a workflow for budget transferring. Learn more about Approval Workflows.

Learn more about internal budget transfers which you can do in the Budget tool, from forecast adjustments, or in the Change Order tool for PCOs and SCOs.

Schedule Budget Snapshots

Set up automatic snapshots to capture budget data at regular intervals. You can configure the frequency, day, time, and duration for which snapshots should be taken:

  1. Choose between weekly or monthly snapshots.
  2. Specify the day of the week for weekly snapshots. For monthly schedules, snapshots occur only once per month.
  3. For monthly schedules, define the specific instance of the day within the month (for example, first, second, or last). The default value is first. For example, selecting second Tuesday schedules the snapshot for the second Tuesday of each month.

Budget snapshot setting

When configuring snapshots, you’ll receive an estimate of how many snapshots will be generated within the specified time frame.

Note: Only one budget snapshot schedule can be active at a time.

To delete a schedule, click Edit schedule, and then select Remove schedule.

Snapshots are accessible in the Budget tool, where you can filter between manually and automatically created snapshots. Learn more about Budget Snapshots.

Budget Forecast

Budget forecast allows you to forecast both revenue and costs, providing visibility into projected fees by calculating the difference between forecasted budget revenue and forecasted costs. This enables general contractors to manage scenarios where time-related resources may change (such as increased hours) without exceeding the Guaranteed Maximum Price (GMP), requiring either change order transfers or internal budget transfers.

Turn on to show budget forecast columns and allow budget forecast adjustments. Recommended when using a cost plus main contract.

If the toggle is on:

Note: This setting cannot be turned off once Forecast Final Budget is selected as the distribution curve in the cash flow settings. See Forecast Settings to learn more.

Related articles:

Date Range Based Resources Update Schedule

Configure the Qty Elapsed update schedule for date range based resources so they stay in sync with your project's billing and actual cost cycles.

Note: This setting can't be changed once any date range based resource has been distributed in cash flow.

The collapsed section shows a summary of the current configuration — for example, how often the budget forecast and cost forecast update and the schedule's start and end dates. Click Edit schedule to open the configuration modal.

To configure the schedule:

  1. Open project Settings, then the Budget tab.
  2. Expand the Date range based resources update schedule section and click Edit schedule. The Edit date range based resources update schedule modal opens.
  3. Configure the Billing schedule (available when budget forecast is on):
    • FrequencyMonthly or Weekly. The frequency you pick determines which fields appear below.
    • Every {N} — The repeat interval for the selected frequency (for example, every 2 months or every 3 weeks).
    • For Monthly frequency, set On day — two dropdowns that pinpoint the exact day each update falls on, such as the Last Day of the month.
    • For Weekly frequency, set Run on — click a day-of-the-week button (S, M, T, W, T, F, S) to choose the day each weekly update runs. Weekly schedules can only run once per week.
    • Covers work from — The reporting period each update represents. Options vary by frequency, for example The same month, 2 months ago, or The same week. The helper text below the field shows a worked example for the selected option (for example, with 2 months ago selected for a monthly schedule, an Apr 30, 2026 update counts Feb 1, 2026 – Feb 28, 2026 as elapsed).
  4. Configure the Actual cost schedule using the same fields. When budget forecast is off, only the Actual cost schedule is configurable.
  5. Set the Start and end dates for when the schedule is in effect.
  6. Click Save schedule. To clear an existing schedule, click Remove schedule.

Edit date range based resources update schedule modal with Monthly Billing schedule, Weekly Actual cost schedule, Covers work from controls, and Start and end dates picker

In the budget bottom flyout, the Billing Frequency and Actual Cost Frequency columns reflect the configured schedule. All date range based resources share the same schedule configuration.

Tip: In the budget overview, the Update button (available to members with Full Control permission) manually refreshes date-range-based calculated values such as Calculated Final Budget, Calculated Final Cost, and related base values. These values are also exposed in the Project value picker when you create or edit a custom column, so calculated columns built on top of them stay in sync with the schedule configured here. A tooltip next to the Update button shows when values were last refreshed.

See Date Range Based Forecasting to learn how to create and manage date range based resources.

Main Contract Schedule of Values

Show change orders in the main contract as line items or a column. Individuals can toggle this view in the main contract, but this selection sets the default view. See the Main Contract article for more information.

You can toggle this view for:

To do so:

  1. Expand the Main Contract Schedule of Values section.
  2. Select As Line Items or As a Column using the radio button.

Main Contract Types

A main contract is the primary contractual agreement entered into directly, for example, between an owner and a main contractor. When creating a new main contract, you can choose your main contract type from the predefined options or add one in the settings to fit your company's needs.

Choose from the presented options:

Tip: System defaults cannot be deleted. You can deactivate them, so they do not show up in the user interface.

To add a main contract type, click Add in the upper left corner of the Main Contract Types.

Main Contract Types settings with Add button to create custom contract types

To assign a contract type to a line item by a drop-down list:

  1. Go to the Budget tool.

  2. Switch to the Main Contract tab.

  3. Enter edit mode by clicking Edit pencil icon.

    Main Contract edit mode interface

  4. Choose the contract type in the Type column.

To learn how to create a contract, see the Work with Contracts article.

Budget Payment Application Approval Workflows

Project administrators can create custom approval workflows for budget payment applications. This allows you to automate the routing of documents for internal review and keep the consistency and transparency of company-defined processes across projects. Learn more about approval workflows.

Tip: You can also create approval workflows for cost-related items.

Document Templates

Create standard main contract and budget payment application template formats using fields that automatically populate with data. See the Document Templates in Cost Management article for more information.

Dates for Main Contract and Budget Payment Application

You can define a default value for dates and choose to have them displayed on the home page. This will help you manage the schedule in Cost Management. To do so, open the More menu More menu icon and click Edit.

Note: Items without the More menu More menu icon can't be displayed on the home page and can't be edited.

If applicable, you can choose the default value for the date. Use the relative date option for cases where an activity is relative to the date of another activity (for example, creating a procurement schedule). The relative date option is only available for editable system-generated dates and custom dates.

Tip: You can create relative dates for custom attributes and custom columns.

Available document variable examples are shown by clicking Show More. You can use those to prepare a document template.

Edit Dates dialog showing default date values and display options for main contract and budget payment application

Custom Attributes

Create custom attributes for the details panels within budget items, main contract items, and budget payment applications in Cost Management. See Create Custom Attributes for more information.

Default Email Message

Customize the default email message for budget payment applications submitted for review.