Docs / Guides

Cost projects and scope

Create and manage cost projects: what a scope is, the project tabs, the Projects table, statuses, attributes and changing the type or currency.

Scope: spaces or JQL#

A cost project's scope is set when you create it, from one of two modes, and can be changed later in Settings:

ModeWhat it matches
Jira SpacesOne or more Jira projects, joined with OR. You pick them from a list.
Jira FilterAny JQL you write, for scopes a space selector cannot express, such as a label across several projects.

Either way the scope becomes one JQL string, which is checked against your site before it is saved. That string is everything the project reads. A cost project can therefore cover one or several Jira projects, and a single Jira project can be covered by more than one cost project at once (for example split by cost account).

A project reads up to 500 issues. See Limits and behaviour for what happens beyond that and how to split a large project.

The Projects table#

The home page lists every project you can see. The table fills in progressively: names and statuses appear at once, and the financial columns (Budget, Actual, Remaining, Progress) fill in as each project finishes calculating.

Project tabs#

TabWhat it shows
OverviewBudget, actual cost, remaining budget, revenue and profit, the monthly cost chart, and schedule, scope and cost progress.
ScopeEvery issue the project counts, with time spent and cost, plus cost by month.
TeamPeople, roles and hourly rates. See Rates, roles and the team.
ExpensesCosts that do not come from logged time. See Expenses.
RevenueWhat the project earns and the profit. See Revenue and profit.
SettingsGeneral, Rates and revenue, Project Attributes, Sharing and Delete project.

Status, tags and timeframe#

A project's status is informational and used for filtering: To do, In progress, On hold, Completed or Archived. Tags are free-form words for organising the table. The timeframe (start and end date) is optional and open-ended on either side; if you leave it empty, the Overview shows the dates calculated from the project's issues.

Changing the type or currency#

You can change a project between monetary and time-based, or change its currency, in Settings. The app asks you to confirm first, because nothing stored is converted:

Project attributes#

Attributes are custom fields (text, number, a pick-one list or a date) that a Jira site administrator defines once under Attributes and attaches to specific projects. An attribute that is attached to no project is hidden everywhere. Once attached, it appears in that project's Settings, can be filled in, and shows as a column in the Projects table. Everyone can see attributes; only site administrators can create, edit or delete them.

Deleting a project#

Only the owner can delete a project. This removes its rates, team, expenses, revenue entries, budget and milestones; the linked Jira issues are untouched. A portfolio that contained the project keeps working and notes that the member was deleted and is excluded from its totals.

Cost Tracker is built on Atlassian Forge and runs entirely on Atlassian's infrastructure. Questions or corrections: info@vudia.site.