---
title: Units
product: SpeedTree Modeler
version: '10'
latest_version: '10'
status: This page documents version 10. The latest version is 10.
canonical: https://docs.unity.com/en-us/speedtree-modeler/10/units
latest_url: https://docs.unity.com/en-us/speedtree-modeler/10/units.md
last_updated: 2026-11-19
generated_at: 2026-11-19T15:05:35.488Z
locale: en-us
---

# Units

> Units refer to the units of measurement used to judge distances in the SpeedTree Modeler, such as feet, meters, and centimeters.

The SpeedTree Modeler doesn't require a specific unit system, but you can set a real-world scale for a model and convert between units when needed.

## Units in the SpeedTree Modeler

SpeedTree, at its core, is unitless. That means a tree can be modeled with any unit you wish to use. If you want a tree to be 50 ft tall or 1500 cm tall, then you can set the height of the tree as 50 or 1500 units, respectively. This value is shown on the height ruler in the [Tree Window](./tree-window.md). You can enter absolute branch lengths in this chosen unit, as well.

Many users follow the unitless workflow and resize their models as needed after importing them into a different application. However, you can also choose a specific unit to work with or convert an existing model to a different unit. If you’re creating a new model, the default unit is feet.

![The top of a tree with the height ruler next to it, measuring it at 57.63 units tall.](/api/media?file=speedtree-modeler/10/media/images/height_ruler.png)

### Changing the scene units

If you’re making a new model and you want to work with a specific unit, you can change the scene unit setting in the **Application Preferences**.

To change the scene units:

1. Go to **Edit** > **Preferences**.
2. In the **Tree Window** tab, change the **Scene unit**.
3. Select **OK**.

If you open a tree that was saved with a different scene unit, you will see a warning dialog alerting you of this. However, no scaling action will happen automatically. You can avoid issues by changing your units to match or by [converting](#converting-units) the tree to your unit.

### Height indicator

![The height indicator. A human figure holds on to the ruler, labeled at 6ft, 1.8m, and 182cm tall. A squirrel also holds on to the height indicator and is labeled at 1ft, 0.3m, and 30cm tall.](/api/media?file=speedtree-modeler/10/media/images/height_indicators_small.jpg)

Note that the only place in SpeedTree that assumes a real-world scale is the height indicator, which is the icon of a person or squirrel standing in the scene holding the height ruler. The indicator makes it easier to eyeball relative heights of a tree to ensure they’re sized correctly in your chosen unit.

Changing the scene unit setting changes the size of the height indicator. The human height indicator is always the equivalent of 6 ft tall. If you set the units to feet, the indicator will be 6 units tall. If centimeters, 182 units tall, etc. The squirrel is always the equivalent of 1 ft tall and will appear only with small models.

| **Scene unit**  | **Size of human height indicator** | **Size of squirrel height indicator** |
| --------------- | ---------------------------------- | ------------------------------------- |
| **Feet**        | 6 units                            | 1 unit                                |
| **Centimeters** | 182 units                          | 30 units                              |
| **Meters**      | 1.8 units                          | 0.3 units                             |
| **Inches**      | 72 units                           | 12 units                              |
| **Yards**       | 2 units                            | 0.33 units                            |
| **Kilometers**  | 0.001 units                        | 0.0003 units                          |
| **Miles**       | 0.001 units                        | 0.0002 units                          |

## Units in the Tree Library

While the Modeler is unitless, trees themselves are modeled in a particular unit. All trees purchased from the SpeedTree Store are modeled in feet.

You may keep your scene unit in feet and [convert](#converting-units) at export time, or convert trees on load into your chosen unit.

## Converting units

The SpeedTree Modeler has a few ways of scaling a tree from one unit to another.

The first is to just change branch lengths, leaf sizes, and/or size scales to get the tree to the size needed. But this is prone to problems. Not everything will scale together, and other things in the scene (forces, collision objects, etc.) will also need to be moved as a result of this scaling. Your tree might end up very different.

### Scene scaling

The Modeler offers two different options to scale the whole scene at once, including the tree itself, forces, and other objects in the scene.

> **Note:**
>
> Scene scaling induces some relative movements which may make your tree subtly change in small ways. If the result doesn't suit your expectations, you can still undo the action.

To scale your scene, select **Tools** in the Modeler's menu, and then select one of the following menu options according to your needs:

| Menu option               | Description                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                           |
| :------------------------ | :-------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Scene unit conversion** | Scale the scene by converting the current scene unit to another unit. | The Modeler attempts to guess the correct unit and set the **Convert from** and **To** field values based on your current scene unit and the units that were previously used in the tree.You can select units such as kilometers, meters, centimeters, miles, yards, feet, and inches.                                                                                                                                    |
| **Arbitrary scene scale** | Scale the scene using a multiplication factor.                        | Enter a **Value** of 2, for example, to make the scene roughly twice its current size.Select **Avoid size scalars** to scale the model without modifying any size scalars on the model.**Attention:** Avoiding size scalars changes the world units (length and mesh scale, generation frequencies, etc.) and might produce unexpected transformations if your model is partially or totally set up with relative values. |

### Export scaling

Another option for scaling between units is in the export dialog. In this way, you can use one unit in the SpeedTree Modeler and convert the model when moving to another application with a different scene unit. Unlike the scene scale tools which can subtly change small things, this method of scaling will not change your model at all, as it is just applied to the outgoing geometry itself.

![The Transform options under the Export dialog.](/api/media?file=speedtree-modeler/10/media/images/export-unit.png)

> **Note:**
>
> Formats that support scene units, such as FBX, will be set to use either the current scene unit (if no conversion is done) or the unit they're set to convert to in the export dialog.
