Budget Types
In Vantage, you can create either Standard or Hierarchical budgets:Standard Budget
This type of budget has one level with a defined budget period and one or more periods of budgeted amounts associated with it. For example, you could use this type of budget to track costs for a single department or project.Hierarchical Budget
This type of budget is made up of multiple child budgets that roll up to a parent budget.- For example, an application team can create individual budgets for AWS, Azure, and Databricks usage and then create a single budget for their application that combines all three of these child budgets. If the AWS budget changes, the parent application budget is automatically updated.
- Similarly, the organization’s FinOps team can consolidate multiple AWS budgets from various teams into a single, comprehensive parent budget to measure all AWS spend.
- You can create a budget hierarchy with a maximum of 10 levels.
- A Hierarchical Budget does not have its own budget period or amounts. Instead, it aggregates the periods and amounts of its child budgets. If a child budget has no allocated budget for a specific period, that period contributes nothing to the parent’s total.
- Every child budget under the same parent must cover the exact same current period, both the same length and the same dates. For example, you can combine budgets that are all monthly and start on the same day, but you can’t mix a monthly budget with a weekly one, and you can’t combine two monthly budgets if one starts on the 1st and the other on the 15th (their periods don’t line up). If a budget’s period doesn’t match, Vantage won’t let you add it as a child.
- Every budget in a hierarchy must share the same metric (Cost or Usage), and Usage budgets must also share the same usage unit. You can’t mix Cost and Usage budgets, or different usage units, under the same parent. The parent budget inherits its metric and unit from its children.
- A child budget can be used only once within a given hierarchy.
- Example: You create a hierarchy with a parent budget for the “Marketing Organization” and child budgets for “Social Media Campaigns,” “Event Marketing,” and “Content Creation.” The child budget for “Social Media Campaigns” cannot also appear under “Event Marketing” within the same hierarchy to avoid duplication in budget calculations.
- A child budget can belong to multiple separate hierarchies.
- Example: Suppose your organization is structured both by departments and projects. A child budget for “Mobile App Redesign” might belong to the “Product Development” department’s hierarchy, while also appearing in a completely separate hierarchy for cross-functional “Q1 Strategic Initiatives.” This allows you to manage and report on budgets across different organizational contexts.
Cost and Usage Budgets
Every budget tracks one of two metrics, which you choose when you create or edit the budget:- Cost: Tracks cumulative dollar spend against your budgeted amount. This is the default, and all existing budgets remain Cost budgets unless you change them.
- Usage: Tracks a usage quantity, such as tokens consumed, EC2 instance-hours, or GB of data transfer, against a budgeted amount expressed in that unit, rather than in dollars. This is useful for monitoring prepaid credits, committed usage, or metered consumption directly in the units you’re billed in.
Tokens or GB) are sourced from that report, and you choose which unit to budget against. Budgeted amounts, actuals, and variance for a Usage budget are then all shown in that unit instead of dollars.
You can also pair a Cost budget and a Usage budget on the same Cost Report, for example to track AI spend in dollars and token consumption side by side. A report holds at most one budget per metric: one Cost and one Usage.
The metric is selected per budget. Within a Hierarchical Budget, every budget must share the same metric and, for Usage budgets, the same usage unit. You can’t mix Cost and Usage budgets, or different usage units, in one hierarchy. See Budget Types for details.
Budget Periods
Every Standard Budget runs on a budget period, which is defined by a start date and a period length. Rather than choosing a named cadence, you enter a number and a unit (Days, Weeks, Months, or Years), for example,1 Week for a weekly budget, 1 Month for a monthly budget, 3 Months for a quarterly budget, or 1 Year for an annual budget.
Vantage automatically generates the sequence of periods from the start date, and you assign a budgeted amount to each period.
A budget period measured in months or years can’t exceed how far back your account retains cost and usage data. This retention window is defined by your Vantage contract. If you choose a period longer than your retention window, Vantage displays an error similar to: “interval exceeds your account’s 6-month cost data retention window.” Period lengths measured in days or weeks are always allowed.
Budgets Screen
To access the main Budgets screen in the console:- From the top navigation, click Financial Planning.
- On the left navigation, select Budgets.

Use the Cost Report, Budget structure (Standard Budgets or Hierarchical Budgets), and Budget metric (Cost Budgets or Usage Budgets) filters to narrow the list, and the search field to find a budget by name. Click Manage Columns to choose which columns are shown or to reset to the defaults; you can also reorder columns by dragging one up or down in the list (or focusing it and using the arrow keys). Required columns such as Name stay in a fixed position. Click Import (next to New budget) to upload budgets from a CSV.
Create a Budget - UI Method
The below instructions describe how to manually create a budget in the UI. You can also upload a CSV file to create a budget. See the section below for details.
1
Begin on the main Budgets screen. From the top right of the screen, click New budget and choose either Standard budget or Hierarchical budget. The options that follow differ for each budget type.
- Standard Budget
- Hierarchical Budget
The New Standard Budget dialog is displayed. Configure the following:
Next, add budget periods and amounts. On the Manage tab, in the Budget Periods section, click Add period to add a period, then enter a Budget amount for each period. You can also click Upload a CSV to import periods for this budget. Each period row displays a Start Date, an End date, and a Budget amount.For a Usage budget, the Budget amount column is labeled with the selected unit (for example, Budget amount (Tokens)), and you enter each period’s budget as a usage quantity rather than a dollar amount.
- Name your budget: Enter a descriptive name. You can rename it later.
- Select costs to measure your budget against: Select the Cost Report you want the budget to track and be displayed on. See the section below for details. Note: Budgets are scoped to a report within a specific workspace, and access can be controlled via teams.
-
Choose what to budget: Select Cost to budget against cumulative spend, or Usage to budget against a usage quantity from the selected Cost Report. You must select a Cost Report first. If you choose Usage, select the usage unit to track (for example,
Tokens). When a report has several usage units, the highest-volume unit is selected by default. See Cost and Usage Budgets for details. Note: A Cost Report can hold one Cost budget and one Usage budget. If the report you select already has a budget for one metric, that option is disabled and the other is selected automatically (for example, “This cost report already has a Cost budget. Create a Usage budget instead.”). A report leaves the picker only once both its Cost and Usage slots are filled. Note: If the selected Cost Report has no usage data, Vantage displays a warning such as “This cost report has no usage unit. Choose a report with usage data.” Choose a report that includes usage data, or budget against Cost instead. - Set a start date: The first budget period starts on this date, and future periods follow the selected schedule.
- Set the period length: Enter a number and select a unit (Days, Weeks, Months, or Years). See Budget Periods for common cadences and limits.
Click to view example image
Click to view example image

2
At the top right, click Save Changes.
Edit Budget Settings
To edit a budget after creation, open it and go to the Manage tab. What you can change depends on the budget type.- Standard Budget
- Hierarchical Budget
The Budget Settings section summarizes the current Name, Cost Report, Metric, Start Date, and Period Length. The Metric row shows whether the budget tracks Cost or Usage (for a Usage budget, the unit is shown, for example Usage (Tokens)). A matching badge appears in the budget’s detail page header, showing Cost or Usage · (for example, Usage · Tokens). Click Edit settings to open the Edit Budget Settings dialog. You can always update the Name and Cost Report. The Start Date and budget frequency (period length) are fixed once the budget has any periods, so those fields are disabled with the tooltip “Start date and budget frequency can’t be edited while budget periods exist.” The Budget Periods section below is where you add, edit, or remove individual periods and amounts.Use the Date range filter above the periods table to control which periods are shown; for a newly created budget it defaults to the last 12 months. Before any periods are added, the section shows the empty state “You haven’t created any budget periods yet.”
You can switch a budget’s metric (Cost or Usage) or its usage unit from Edit settings, but doing so removes any periods you’ve already entered, since amounts are denominated in different units. Vantage warns before you save: “Saving this change will delete all existing budget periods. This action cannot be undone.”
If periods you just added or imported don’t appear in the Budget Periods table, they’re most likely outside the current Date range filter rather than missing. Open the Date range filter and widen the range.
A budget’s cadence (its start date and period length) can be changed only while the budget has no periods. Once any period exists, the cadence is locked. Attempting to change it returns the error “Budget cadence cannot be changed after creation.”
Create a Budget - CSV Import Method
If you have existing budgets in spreadsheets or another tool, you can import them all at once by uploading a CSV file.Expected Format
Budget import files must adhere to the following requirements:- The file must be in a valid CSV format.
- The header row of the CSV must start with a unique string or identifier (e.g.,
Budget Name).- The remaining values in the header row are budget period start dates. Use
YYYY-MMformat for monthly periods (e.g.,2026-08for August 2026), orYYYY-MM-DDfor any cadence (e.g.,2026-08-01). Each period column header is the period’s start date, and the period ends the day before the next column.
- The remaining values in the header row are budget period start dates. Use
- Each additional row in the CSV must start with the name of the budget. Corresponding values must be expressed as decimals (e.g.,
25000.00) for every period with an associated budget. If there is no budget for a period, the value can be blank. - If the budget is a Hierarchical Budget, include the
Parent Budgetcolumn. - To set a budget’s period cadence, include the optional
Start Date,Interval Count, andInterval Unitcolumns.Interval Unitmust be one ofday,week,month, oryear. If you omit these columns, the budget uses the default monthly cadence. - To create a Usage budget, include the optional
Budget metriccolumn set tocostorusage, and theUsage unitcolumn set to a usage unit available on the budget’s Cost Report (for example,Tokens). If you omitBudget metric, the budget defaults tocost. Period values for a Usage budget are entered as usage quantities rather than dollars.
Standard Budget Format
The below example of three Standard Budgets shows a readable view, CSV file format, the budget import screen, and the final budgets in Vantage. Team 3 does not have a budget for 2026-10, and therefore, no budget period is added for Team 3 during that timeframe. On the import, the period start and end date are set based on the column headers.- Standard Budget
- CSV File
- Import Screen
- Imported Budgets
Set the Budget Period via CSV
To import a budget on a cadence other than monthly, add theStart Date, Interval Count, and Interval Unit columns and use YYYY-MM-DD period column headers that align to the cadence. The example below creates a budget on a two-week cadence starting 2026-08-01, with $5,000 budgeted per period.
- Standard Budget
- CSV File
Usage Budget Format
To import a Usage budget, add theBudget metric and Usage unit columns. Set Budget metric to usage and Usage unit to a unit available on the budget’s Cost Report. Period values are usage quantities, not dollars. The example below budgets a monthly token allowance.
- Usage Budget
- CSV File
You can combine the Usage columns with the cadence columns (
Start Date, Interval Count, Interval Unit) and the Parent Budget column, just like Cost budgets. Remember that every budget in a hierarchy must use the same metric and usage unit.Hierarchical Budget Format
The below example of a Hierarchical Budget shows a readable view, CSV file format, the budget import screen, and the final budget in Vantage. Note that the parent budgets—Engineering Org, Development Dept, and Infrastructure Dept—do not have any amounts listed since these budgets are composed of the corresponding child budgets—Frontend Redesign, Backend Refactor, New Cloud Environment, and Cost Optimization Task. The associated next-level parent is listed in theParent Budget column.
- Hierarchical Budget
- CSV File
- Import Screen
- Imported Budgets
2026-08-01, so they roll up cleanly under the parent.
- Hierarchical Budget
- CSV File
Import Budget
Once your CSV file is prepared, follow the steps below to import any type of budget.1
From the top navigation, click Financial Planning.
2
On the left navigation, select Budgets.
3
From the top right of the screen, click Import. The Import Budget Data modal is displayed.
4
Click Choose File and select a CSV file.
5
Click Upload. The Review Imported Data screen is displayed. If no errors are present, click Confirm > OK.
When you open an imported budget, its Manage tab may not show every period right away because the Date range filter defaults to the last 12 months. If periods look missing, open the Date range filter and widen the range.
Fix Import Errors
If a formatting error is found in your imported CSV file, the import wizard indicates where the error occurred. To fix the error, correct the issue in your source CSV and re-upload the file. In the below example, an error occurred because the CSV file contained duplicate values in the header row.- Error Screen
- Source CSV File

Budget name: error (for example, New Cloud Environment: Child budgets must share the same current period.). Use the table below to match an error to a fix. Also make sure the file has no extra blank columns and that amounts are plain decimals (e.g., 56000.00, not $56,000.00).
Watch: overwrite an existing budget on import
Watch: overwrite an existing budget on import
View Budget Performance
For any budget, select the Performance tab to see how the budget is tracking against its budgeted amounts. The Performance tab has three parts: summary cards, a time-series chart, and a per-period table. The details vary slightly depending on whether you are viewing a Standard Budget or a Hierarchical (parent) budget.For a Usage budget, the Performance tab is denominated in the budget’s usage unit instead of dollars. The summary cards, chart, and per-period table all show budgeted amounts, actuals, and variance in that unit (for example, Tokens).
Performance Summary Cards
At the top of the tab, summary cards provide an at-a-glance view of the current period:- Standard Budget
- Hierarchical Budget
- Usage Budget

Utilization States
A status badge on the utilization card (and in the optional Status column on the Budgets screen) reflects one of the following states:Performance Chart
Below the cards, a time-series chart plots cumulative Budget against Actuals over time. For a Usage budget, the actuals series is labeled with the unit (for example, Actuals (Tokens)). You can:- Adjust the date range with the date range picker.
- Change the chart granularity (day, week, month, or year).
- Toggle whether variance is displayed as a dollar amount or a percentage.
Performance Table
The table below the chart differs depending on the budget type.- Standard Budget
- Hierarchical Budget
Each row is a budget period, with the following columns:
- Period: The date range of the period. The in-progress period is tagged with a Current Period badge, and future periods are tagged Forecast.
- Budget: The budgeted amount for the period. For a Usage budget, this column includes the unit (for example, Budget (Tokens)).
- Actuals: Actual cost or usage for the period. For a Usage budget, this column includes the unit (for example, Actuals (Tokens)). For the current period, this reflects actuals to date; the value is highlighted red if it exceeds the budget.
- Variance ($) or Variance (%): How far actuals are over or under the budgeted amount, depending on the variance display you selected. For a Usage budget, currency variance is labeled with the unit (for example, Variance (Tokens)).
View Budgets on Cost Reports
Once a budget is assigned to a Cost Report, a budget report with current-period performance is displayed at the top of the Cost Report. The budget reflects amortized costs throughout the period, indicating whether spending is above or below the budget so far. The report’s accrued and forecasted budget labels—shown in the top-line metric, chart tooltip, and chart legend—include the budget’s name (for example, Accrued [Developer Costs] Budget and Forecasted [Developer Costs] Budget).
Because budget amounts are spread evenly across the days in each period, aggregated views (such as Weekly or Monthly) may show the budget line dip for partial periods at the start or end of the budget period.

Cost and Usage Budgets on the Same Report
When a Cost Report has both a Cost budget and a Usage budget, the report shows four summary figures at the top: Accrued Actuals (Costs), the Cost budget (for example, Accrued [Developer Costs] Budget), Accrued Actuals for the usage unit (for example, Accrued Actuals (Tokens)), and the Usage budget (for example, Accrued [AI Token Budget] Budget). This lets finance watch spend while platform teams watch consumption on a single report. The same four figures appear on the report’s dashboard widget. The budget line on the chart follows the metric you’re viewing: the Cost budget is drawn in the dollar (Cost) view, and the Usage budget is drawn when the report is in usage view and the table includes that budget’s unit, even if other units appear alongside it. Switch the report between Cost and its usage unit to see each budget’s line. Count charts show no budget line.Budget Alerts
Budget alerts are automated alerts based on configurable budget thresholds. Create a budget alert for any of your existing budgets to notify you when a percentage of a budget is exceeded. You can configure alerts to notify Vantage users via email, Slack, Microsoft Teams, or Jira. You can optionally scope an alert to a window at the beginning or end of the budget period (e.g., within the first 10 days of the period). You can create budget alerts for any budget: Standard or Hierarchical, Cost or Usage. Because thresholds are percentage-based, they apply the same way whether the budget tracks cost or a usage quantity. For Hierarchical Budgets, the amounts associated with the child budgets are aggregated at the parent budget level to determine if a budget alert should be set off. You can manage budget alerts in two places:- From a budget’s detail page, using the Budget Alerts drawer (the steps below).
- From the standalone Budget Alerts screen, which lists every budget alert in the workspace. To open it, click Financial Planning in the top navigation, then select Budget Alerts in the left navigation.
If you want to send alerts to Slack, Microsoft Teams, or Jira, see the Slack, Microsoft Teams, or Jira integration documentation. Once you’ve set up an integration, follow the steps below to set up a budget alert.
1
Open the budget you want to alert on. From the top of the budget’s detail page, click Budget Alerts to open the Budget Alerts drawer, which lists any existing alerts for the budget.

2
Click Add budget alert. The New Budget Alert panel is displayed.
3
Configure the following parameters:

- For Budget, select one or more budgets the alert applies to.
- For Alert when spend exceeds, enter a percentage threshold (e.g., 85% of the budget). You’ll receive an alert only if the threshold is reached.
- Optionally, for Within first, enter a number of days (between 1 and 31) and choose beginning of the period or end of the period to scope the alert to a window within the budget period.
- For Email recipients, select the recipients who are members of your team in Vantage that you want to receive the alert.
- Under App alerts, optionally select any Slack channels, Microsoft Teams channels, or Jira projects you want to receive the alert.
Click to view example image
Click to view example image

4
Click Save Budget Alert. Budget alerts will look similar to the below image.

Budget Alert Limitations
At this time, only dynamic, percentage-based thresholds are supported. Budget alerts can be configured only to send alerts based on actual, not forecasted costs.A single cost increase will not typically trigger a budget alert. If you are interested in this feature, see the Cost Anomaly Alerts documentation.
Keep the Within first window shorter than the budget’s period. If the number of days is longer than the period length (for example, a 20-day window on a weekly budget), the alert is skipped and won’t fire.






