Skip to main content

Units Management

Dimensions and Units are managed from Settings → Units, separately from the Item Type catalog since they're their own data model shared across every "Unit Value" field.

Browsing Dimensions and Units​

The Units page lists every Dimension available to your Organization — the broad, pre-built global set (Length, Mass, Electrical Resistance, Voltage, and more) plus any custom ones your Organization has defined. Expanding a Dimension shows its Units: symbol, full name, and its conversion factor relative to that Dimension's base unit.

:::info Screenshot placeholder The Units settings page with a couple of Dimensions expanded, showing their Units in a small table (symbol, name, factor). :::

Creating a custom Dimension​

If none of the built-in Dimensions fit what you're measuring, create a new one by naming it and defining its base unit at the same time (name + symbol, e.g. Dimension "Amp-Hours," base unit "Ah") — a Dimension always needs exactly one base unit to normalize everything else against, so the two are created together in a single step.

Adding Units to a Dimension​

Within an existing Dimension (global or your own), add a new Unit by giving it a symbol, a name, and its conversion factor to that Dimension's base unit. Once created, a Unit's factor can't be changed — this is deliberate, since altering it after values already exist would silently corrupt every value already stored using that unit. If a factor turns out to be wrong, delete the Unit (blocked if anything is currently using it) and recreate it correctly. The Unit's name and symbol, by contrast, can be edited freely at any time, since renaming doesn't affect any stored value.

Deleting​

Like Item Types and Fields, a Unit or Dimension can't be deleted while still referenced by a Field or an actual stored value — you'll see a clear error rather than a silent failure or data corruption. Global Dimensions/Units are read-only, same as the global Item Type library.

Where this shows up elsewhere​

You'll encounter Dimensions and Units indirectly whenever you attach a Unit Value field to an Item Type (Item Type Catalog) or filter Search by a numeric range on a unit-based field — this page is where the underlying list of available units actually comes from.