diff --git a/docs/docs/assets/images/concepts/unit_dimensionless.png b/docs/docs/assets/images/concepts/unit_dimensionless.png new file mode 100644 index 0000000000..68b8942178 Binary files /dev/null and b/docs/docs/assets/images/concepts/unit_dimensionless.png differ diff --git a/docs/docs/concepts/units.md b/docs/docs/concepts/units.md index b46e61a745..ce71012455 100644 --- a/docs/docs/concepts/units.md +++ b/docs/docs/concepts/units.md @@ -72,6 +72,27 @@ Custom units can be defined to provide a new physical quantity, link existing un !!! tip "More Info" For further information, refer to the [pint documentation](https://pint.readthedocs.io/en/stable/advanced/defining.html) regarding custom unit definition +### Built-in Custom Units + +InvenTree provides the following built-in custom units: + +| Unit | Description | +| ---- | ----------- | +| `piece` | A single item, dimensionless | +| `each` | A single item, dimensionless | +| `dozen` | Twelve items, dimensionless | +| `hundred` | One hundred items, dimensionless | +| `thousand` | One thousand items, dimensionless | + ### Create Custom Units To view, edit and create custom units, locate the *Physical Units* tab in the [settings panel](../settings/global.md). + + +### Dimensionless Units + +It is possible to define custom dimensionless units. These units can be used to provide context to otherwise dimensionless quantities. + +To create a new dimensionless unit, you must enter the literal `1` as the definition of the unit: + +{{ image("concepts/unit_dimensionless.png", "Creating a dimensionless custom unit") }}