A building type is composed of one or several space-use types that define the combination of usages in a building. A building type is used as a template to build out plausible buildings respecting the zoning code.
You can edit existing building types and propose new building types while editing a plan. Proposed building types are only available in the corresponding plan; they are not available across the entire city.
Add a building type
You can add new building types to a plan in development mode 
or in the plan configuration. Use the development mode option to add types one by one. Use the import options in the plan configuration to add multiple types from a hosted feature table or a spreadsheet.
Development mode
To add a new building type in development mode , complete the following steps:
- Open the plan editor.
- Click Development in the header to switch to development mode.
Ensure that the side panel on the right is expanded and is in development mode. To show or hide the side panel, click the expand button
. - Click Building and space use types
in the upper right corner of the side panel. The side panel displays two tabs. The Building types tab is active by default. It lists the building types for the plan.
- Click the Add button
at the upper right of the side panel. The New building type dialog box appears.
- Provide a name for the building type.
- Optionally, provide a Custom ID value.
This ID can be used for additional identification.
- Specify the building parts for the building type in the Building parts configuration section.
Structural parts are building parts that are above ground; substructural parts are below ground.
- Define additional Building Type settings (see the Define building type settings section below for details).
- Click OK.
The new building type is saved and added to the building types list with a proposal flag next to its name.
- To locate this building type in the list, search for it using the search field. To filter the list of building types, click the Filter button
to the right of the search bar.
Add building types to the plan configuration
To add new building types to the plan configuration, complete the following steps:
- Open the plan editor.
- Expand the drop-down menu named after the plan and choose Configure plan.
The plan configuration opens to the general plan settings tab by default.
- Click Development and click Building types.
- Click Add and choose from the available options:
- Single item—Add a single building type.
- From spreadsheet—Import multiple types from a spreadsheet.
- From feature table—Import multiple types from a hosted feature table.
See Manage building types to learn more about these options.
- Click Return to plan
in the header when you finish adding types.
Define building type settings
You can define building type settings on the building type dialog box. You can access it when adding a new type or by clicking the Configure button 
in the list of building types when working with an existing type. You can access this list from development mode or from the plan configuration. See the Add a building type section above to learn how to get to the list of types.
Add building parts
To add a building part to a building type, complete the following steps:
- To add structural parts to the building type, click the Add button in the Building parts configuration section.
A new part with a default space-use type is added.
- Click the added building part to change the space use in the Space use type section to the right of the Building parts configuration section.
The color updates to reflect the new space use.
- Provide values for the minimum and maximum number of floors.
- In the Massing drop-down list, specify whether the building part is a podium or a tower:
- Podium—Maximize the building footprint within the allowed zoning regulations.
- Tower—Maximize the building height within the allowed zoning regulations.
- Check the check box in the Floor area section if the building part will count toward GFA and FAR calculations.
If the check box is unchecked, the building part is excluded from GFA and FAR calculations. This means that the building part will not count toward a FAR limitation set in zoning regulations. By default, all parts above ground count toward GFA and FAR calculations, and all substructural parts do not.
- Optionally, click a building part in the Building parts configuration section, click the Configure button , and select one of the options to add more building parts.
- Optionally, add substructural parts to the building type.
- Click the building part that is above the horizontal black line in the Building parts configuration section, click the Configure button , and choose the Add part below (substructure) option.
- Follow the steps above to define the parameters for the substructural building parts.
- Click the building part that is above the horizontal black line in the Building parts configuration section, click the Configure button
Note:
You can add multiple structural and substructural parts to a building type.
Building footprint
You can define the building footprint settings on the Building type dialog box. The Building type dialog box contains the following sections:
- Minimum floor area
- Footprint shape
- Maximum footprint length (only available if the Footprint shape value is Rectangle)
- Maximum footprint width (only available if the Footprint shape value is Rectangle)
- Minimum building segment length (only available if the Footprint shape value is Rectangle)
- Minimum building segment width (only available if the Footprint shape value is Rectangle)
- Alignment
- Secondary alignment
Edit a building type
You can edit all the parameters in a building type. You can also view the settings of a building type and generate a new building type based on the settings of an existing type.
To edit a building type from the list of building types, complete the following steps:
Note:
See the Add a building type section above to learn how to get to the list of types.
- Click the Configure button of the building type you want to edit.
The editing dialog box appears.
- Edit the content of the building type.
- Click OK.
Your changes are saved. If this building type has been assigned to a parcel, you must reapply it to that parcel to ensure your changes are reflected.
Note:
When modifying an existing building type, the changes are only applied to the current plan.
Tip:
Choose the Proposed in this plan option in the building types filter to see all the building types that have been added.
Define a dwelling unit
A dwelling unit is a structure that is designed for occupancy by a household of one or more persons. It can also be considered a single-family house. For building types, you can assign one building per parcel. For dwelling units, you can build multiple units on one parcel.
To define a dwelling unit, complete the following steps:
- Open the plan editor.
- Click Development in the header to switch to development mode.
- Click Building and space use types in the upper right corner of the side panel.
The side panel displays two tabs. The Building types tab is active by default. It lists the building types for the plan.
- Click the Add button at the upper right of the side panel.
The New Building Type dialog box appears.
- Provide a name for the building type.
- Choose Dwelling units in the Type section.
- Specify the space-use type for the dwelling unit in the Dwelling units configuration section.
For dwelling units, you can only use residential space-use types. This must be defined for each space-use type, either at the urban model level (see Manage space-use types) or at a plan level (see Work with space-use types)—by checking the corresponding check box.
- Specify the other building type parameters according to your requirements.
The total area per dwelling unit is configured in the space-use type.
The building footprint shape of a dwelling unit is always a square.
- Set the Dwelling units density (DUA) value.
The density value is the minimal lot size that belongs to a single dwelling unit.
For example, a density value of four dwelling units per hectare (100 by 100 meters) means that on a perfectly squared one-hectare parcel, a single dwelling unit can fill the area of a square with a 25-meter edge length.
- Set the Minimum distance between units value.
The minimum distance between dwelling units is the distance between individual buildings (wall to wall).
- Click OK.
The dwelling unit definition is saved as a new building type and added to the building types list.
.Note:
You can also configure dwelling units on the Development tab in the plan configuration.