User Guide
03.1 · Resources

What is a Resource?

A Resource is a reusable rate record. Every cost in TX1 eventually points back to a Resource. It is the "price list entry" for the platform.

Why Resources Matter

Instead of typing $180/m³ into every concrete item, you create one Concrete resource at $180/m³ and every item references it. When the supplier updates their price, you change the resource once and every item re-prices automatically (via the Cascade service).

Fundamental Properties

PropertyPurpose
NameIdentifier. "Concrete 25MPa", "Electrician — Leading Hand", etc.
TypeLabour / Material / Plant / Subcontract / Other (or a custom type).
Unitm, m², m³, hr, each, t, kg, lt, day, wk.
CurrencyDefault from the project's currency.
BaseRateThe raw rate per unit.
AppliedFactorMultiplier for location, productivity, difficulty. Default 1.0.
MarkupPercentageResource-level markup for the resource's SellRate (separate from project markup).

Derived Fields

FieldFormula
EffectiveBaseRateBaseRate × AppliedFactor
DirectRateEffectiveBaseRate (used by items as their ResourceRate)
CalculatedSellRateEffectiveBaseRate × (1 + MarkupPercentage/100)

Scope: Project vs Master

  • Project resources live with a single project (ProjectId set).
  • Master resources live in the Master Library (ProjectId null) and can be global or scoped to an organisation (see MasterScope).

Project resources can be linked to a master. When the master changes, TX1 flags the project resource as UpdateAvailable, and you can sync manually or automatically (see 11.2–11.3).

Omitted, Bold, Coloured

Resources carry the same formatting fields as items (IsBold, IsItalic, IsUnderlined, TextColor, HighlightColor) and an IsOmitted flag. Omitted resources still exist but are ignored by items that try to use them.

Built-Up Resources

If IsBuiltUp is true, the resource has no BaseRate; its rate is calculated from component resources via BuiltUpResourceBreakdown rows. See 03.5.

Carbon Data

Every resource carries:

  • CarbonEmissionFactor — kgCO₂e per unit.
  • EmissionUnit — label (kgCO₂e, tCO₂e).
  • EmissionScope — 1, 2 or 3 (default 3).

This propagates to items through the Carbon feature (section 09).