> For the complete documentation index, see [llms.txt](https://help.transmutr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.transmutr.com/sketchup-extension.md).

# SketchUp extension

Transmutr installs a SketchUp extension automatically when you launch the desktop app.

## Menu and toolbar

In SketchUp:

* **Extensions → Transmutr**
  * **Import model**: launch Transmutr to convert an external asset into this model
  * **Help portal**: open Lindalë support for Transmutr
* Toolbar button: **Import model**

## Import an external asset

1. Open your SketchUp model.
2. Click **Import model**.
3. Transmutr opens. [Load](/importing/loading-files.md), [edit](broken://pages/UuKUN2BkX0mYNkLzqZfU), and [**Export**](/exporting/export.md) the asset.
4. The result is sent into SketchUp. Use the place tool to position each component.

See [Send to SketchUp](/exporting/send-to-sketchup.md)

## Edit in Transmutr

Round-trip an existing group or component:

1. Right-click a **single** group or component.
2. Choose **Edit in Transmutr**.
3. If the component references an external definition path, SketchUp may ask whether to open the source file or a temporary `.skp`.
4. Edit in Transmutr, then export.
5. SketchUp replaces the definition with the result.

{% hint style="info" %}
Groups edited this way are converted to **components** when they come back into SketchUp.
{% endhint %}

While waiting, SketchUp shows **Waiting for Transmutr… Press ESC to cancel.**

## Connection

When the apps are linked, SketchUp notifies you that it is **connected to Transmutr**. [Options](/options.md) in the desktop app also list connected SketchUp instances.

If SketchUp reports that it cannot locate or start Transmutr, reinstall the desktop app and launch it once so the extension is refreshed.