# Finch 101: Upload Mass from Revit

{% embed url="<https://youtu.be/tXwbv3aGFrc>" %}

### 1. Launch the Finch Plugin in Revit

**Go to Add-Ins → `Finch Plugin`**

Make sure you’ve installed the Finch Revit plugin. Open your project in Revit and launch the Finch plugin from the **Add-Ins** tab.

***

### 2. Create your conceptual mass in Revit

1. Open Revit and navigate to the **Massing & Site** tab.
2. Select **In-Place Mass** under *Conceptual Mass*.
3. Draw your **conceptual massing volumes**.
   * ⚠️ **Important:** All your building volumes must be contained within **one conceptual mass family**.
   * This ensures Finch recognizes your geometry as a *single building*, not multiple.

***

### 3. Master Planning with Multiple Masses

If your project includes multiple buildings (e.g., a master plan), model them as separate conceptual masses. Finch will allow you to **toggle and choose** which masses to upload during the process.

***

### 4. Add Grids for Better Floorplate Control

Use the `Architecture` tab to draw **grid lines** in your plan view. Finch can interpret these grids when laying out internal walls and organizing floorplates.

***

### 5. Assign levels and mass floors

1. To define story heights, use the **Mass Floors** tool:
   * Select your conceptual mass.
   * Click **Mass Floors** from the top ribbon.
   * Choose the levels you want to assign.
2. You can also skip this step — Finch will automatically generate story heights if levels are not defined.

***

### 6. Upload to Finch

**Navigate to the `Finch Plugin Panel`**

* Select the **project** you want to work with.
* Choose the **`variant`** where you want the mass to be uploaded.
* Make sure **"`Massing`"** is highlighted.

Click **Upload Massing**.

**Choose Massing to Upload**

If you have multiple mass families, a window will appear allowing you to **toggle** through each one.

* To upload them as a single mass, check **"`Group All`"**.
* For individual uploads, select the relevant mass.

In this case, we’re uploading one building, so we’ll just select **Upload Building Mass**.

***

### 7. Confirm Upload in Finch

**Open Finch in Your Browser**

After uploading, your **conceptual mass** will appear in Finch. You’ll see your building with **key metrics** calculated automatically.

You're now ready to start working on the **interior layouts** using Finch’s design tools.


---

# 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://docs.finch3d.com/courses/finch-101/finch-101-upload-mass-from-revit.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.
