Skip to main content
This reference explains how multiplier ranges work, the rules that keep a branch’s set of ranges valid, and the error messages you may see when a range overlaps another, leaves a gap, or is set up incorrectly. Multiplier ranges live under Settings → Price book → Multiplier ranges.

What a multiplier range is

A multiplier range maps a job’s total cost to a pair of pricing multipliers. Each range covers a band of cost and, for any job whose cost falls in that band, supplies a lowest and highest multiplier used to price the job.

Fields on a range

Each multiplier range has these fields:
  • Name — a display label, for example “0−0 - 1,000”. Required, up to 200 characters.
  • Minimum cost — the inclusive lower end of the cost band. Required, and cannot be negative.
  • Maximum cost — the inclusive upper end of the cost band. Optional. Leave it empty on the highest range to mean “no maximum” — that range then covers every cost at or above its minimum.
  • Lowest multiplier and Highest multiplier — the two multipliers applied to jobs in this band. Both required, and each must be between 0 and 10.

How a range is matched to a job

The cost band is inclusive at both ends. When a job is priced, the first range whose band contains the job’s total cost is selected, and its lowest and highest multipliers are read back. A range with no maximum matches every cost at or above its minimum. Because both ends are inclusive, your ranges must form a clean, non-overlapping cover of every possible cost. If two ranges both contain a cost, pricing is ambiguous; if no range contains a cost, that job cannot be priced.

The overlap rule

Two ranges in the same branch may not overlap

Within a single branch’s set of multiplier ranges, no two ranges may cover the same cost. Two ranges overlap when their cost bands touch at any point.

Touching counts as overlapping

Because both ends of a band are inclusive, a range that ends at 1,000andarangethatstartsat1,000 and a range that starts at 1,000 both match a 1,000job.Sorangesthatmerelytouch—oneendingexactlywherethenextbegins—aretreatedasanoverlap,notacleanhand−off.Tositnexttoeachotherwithoutoverlapping,consecutivewhole−dollarrangesshouldleaveaone−dollarstep,forexample‘1,000 job. So ranges that merely touch — one ending exactly where the next begins — are treated as an overlap, not a clean hand-off. To sit next to each other without overlapping, consecutive whole-dollar ranges should leave a one-dollar step, for example `0 - 1,000‘followedbyarangestartingat1,000` followed by a range starting at 1,001.

The same range can’t be assigned twice

A branch can’t list the same multiplier range more than once in its set.

Where the rule applies

Overlap is checked per branch, not across your whole workspace. Your workspace can hold many ranges; the requirement is only that the set of ranges a single branch uses is internally consistent. The same range can be reused by different branches. The overlap rule is enforced at two moments:
  1. When you assign ranges to a branch. If the set you save contains any overlapping pair, the save is rejected.
  2. When you edit a range’s cost bounds. If moving a range’s minimum or maximum would make it overlap another range in a branch that already uses it, the edit is rejected. This check only runs when you actually change a cost bound.

Overlap error messages

Coverage: no gaps, start at $0, no maximum at the top

Beyond avoiding overlap, a branch’s ranges should form a continuous cover with no gaps, so every possible job cost can be priced.

Coverage requirements

  • There must be at least one range.
  • The lowest range must start at $0.
  • The ranges must be contiguous — no uncovered cost band between two ranges.
  • The highest range must have no maximum cost, so jobs above any fixed amount can still be priced.
If a job’s cost falls in a gap between ranges, or above the highest range’s maximum, that job cannot be priced.

Coverage error messages

Consecutive whole-dollar ranges that differ by one dollar — for example $0 - $1,000 followed by a range starting at $1,001 — are treated as contiguous and are not flagged as a gap.

Per-range field rules

Independent of overlap and coverage, each individual range must be internally well-formed. These rules are checked both as you fill in the form and again when the change is saved.

Field rules for a single range

  • Maximum cost must be greater than or equal to minimum cost (when a maximum is set).
  • Highest multiplier must be greater than or equal to lowest multiplier.
  • Each multiplier must be between 0 and 10.

Field error messages