# Converting Units

Use `to` or `in` or `as` to convert into a particular unit.

```
10 km in m                    | 10,000 m
5 hours 30 minutes to seconds | 19,800 seconds
100 pounds in kg              | 45.36 kg
```

Or alternatively:

```
meters in 10 km  | 10,000 m
days in 3 weeks  | 21 days
seconds in a day | 86,400 s
```

{% hint style="success" %}
As a shorthand, you can also type two unit names without values to see the conversion:

"km m" (= 1,000 m)
{% endhint %}

Soulver uses unit symbols (rather than its full name) in the answer column.

Control-click on an answer to see the full unit name

![](/files/RUAGRy1mknHwAZeGI8E4)

## Notes on Units

#### **Mixing Units & Plain Numbers**

When mixing plain numbers with units, the nearest unit will be used automatically. This is called **unit assimilation**.

```
300 + 20 km | 320 km
$20 + 30    | $50.00
```

#### **Adding & Subtracting Mixed Units**

When doing calculations with mixed unit types, **the larger unit wins**:

```
1km + 1,000m | 2 km
```

When units don't share a common base unit, the **last used unit wins:**

```
$200 + €200 | €308.84
```

#### **Multiplying Units**

Soulver only supports units that have been pre-defined in its math engine, not compound units that do "not exist":

```
10m × 10m       | 100 m² // area, a supported unit type
3 kg × 3 liters | // Not "9 kg liters", this unit does not exist
```

Soulver will make an implicit rate when a supported unit cannot be created through multiplication:

```
$30 × 4 days | $120.00
// the above is interpreted as $30/day × 4 days
```

#### **Creating Custom Units**

You can add additional units to Soulver in the `Calculator > Custom Units` settings.

{% hint style="info" %}
Custom units are defined in terms of an existing units.

You cannot add new unit categories to Soulver (yet).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.soulver.app/syntax-reference/units-and-conversions/units.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.