> ## Documentation Index
> Fetch the complete documentation index at: https://speckle-assistant.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Basic Usage

export const connector_0 = "SketchUp"

<div class="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border-2 border-red-600 bg-red-100/50 dark:border-red-600 dark:bg-red-400/20" data-callout-type="warning">
  <div class="mt-0.5 w-4" data-component-part="callout-icon">
    <svg class="flex-none w-5 h-5 text-red-700 dark:text-red-300" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" aria-label="Warning">
      <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
    </svg>
  </div>

  <div class="text-sm prose min-w-0 w-full text-red-700 dark:text-red-300" data-component-part="callout-content">
    <b>Notice</b>: This user guide is based on the legacy {connector_0} connector.<br />
    We recommend using our new connectors instead, as they are easier to use and actively maintained. This legacy documentation may not be up to date.
  </div>
</div>

<Note>
  We have renamed some core concepts in Speckle to be more widely understandable.

  * <i>Streams</i> have been renamed to <b>projects</b>
  * <i>Branches</i> have been renamed to <b>models</b>
  * <i>Commits</i> have been renamed to <b>versions</b>
</Note>

In this page, we'll show some basic operations you can do using SketchUp connector.

## Sending data

<Frame>
  <video autoPlay muted loop src="https://mintcdn.com/speckle-assistant/fqa23GjG0dFWAgwW/images/legacy/sketchup/sending.mp4?fit=max&auto=format&n=fqa23GjG0dFWAgwW&q=85&s=6dc4c12a2e6d0fc26c1b4f9a32065adb" type="video/mp4" data-path="images/legacy/sketchup/sending.mp4" />
</Frame>

For the moment, there is only one send mode: **Selection**.

To send data:

1. Select all the objects you want to send.
2. Click on the "**Send**" cube.
3. If you wish to change the target model, click on the selected model and choose the desired model from the dropdown menu.

## Receiving data

<Frame>
  <video autoPlay muted loop src="https://mintcdn.com/speckle-assistant/fqa23GjG0dFWAgwW/images/legacy/sketchup/receiving.mp4?fit=max&auto=format&n=fqa23GjG0dFWAgwW&q=85&s=93b10ec073e3ade444caac5cc3aab916" type="video/mp4" data-path="images/legacy/sketchup/receiving.mp4" />
</Frame>

Receiving models in SketchUp is as simple as clicking the "**Receive**" cube. As with sending, you can switch the targeted model and the particular version to receive.

<Warning>
  Note that if you sent SketchUp groups to a model, they will be received as component instances rather than groups.
</Warning>

## Creating a new project

<Frame>
  <video autoPlay muted loop src="https://mintcdn.com/speckle-assistant/fqa23GjG0dFWAgwW/images/legacy/sketchup/create-stream.mp4?fit=max&auto=format&n=fqa23GjG0dFWAgwW&q=85&s=6b297980e1e4cecf3bfc85e9987fb690" type="video/mp4" data-path="images/legacy/sketchup/create-stream.mp4" />
</Frame>

Creating a new project is also really easy.

1. Click on the "**Create New Project**" button.
2. A dialog box will appear. Provide a **name** for your project and an optional **description**.
3. To make your project **private**, use the toggle option.
4. Click on the "**Create**" button to finalize and create your project.

That's it! Your new project is now successfully created.

## Creating a model

<Frame>
  <video autoPlay muted loop src="https://mintcdn.com/speckle-assistant/fqa23GjG0dFWAgwW/images/legacy/sketchup/create-branch.mp4?fit=max&auto=format&n=fqa23GjG0dFWAgwW&q=85&s=cbe39520dac24f18be69b9536f67586b" type="video/mp4" data-path="images/legacy/sketchup/create-branch.mp4" />
</Frame>

To create a new model:

1. Hover over the model button. "**+**" button will appear on the left. Click on it.
2. A new dialog box will open where you can **name** your model and optionally provide a **description** for it.
3. Click on "**Create**".

The newly created model will become active, ready for you to start working on it.

## Adding a project by URL

<Frame>
  <video autoPlay muted loop src="https://mintcdn.com/speckle-assistant/fqa23GjG0dFWAgwW/images/legacy/sketchup/add-by-id.mp4?fit=max&auto=format&n=fqa23GjG0dFWAgwW&q=85&s=0c2b85bf07c189103fb055014c2cdd4b" type="video/mp4" data-path="images/legacy/sketchup/add-by-id.mp4" />
</Frame>

If you have the URL of the project you want to receive, you can easily add it using the "**Add By ID or URL**" button. Paste the URL of the data you want to receive and click "**Add**". A Project Card will be added, with the model and version selected from the pasted URL.

## Switching accounts

<Frame>
  <video autoPlay muted loop src="https://mintcdn.com/speckle-assistant/fqa23GjG0dFWAgwW/images/legacy/sketchup/switching-accounts.mp4?fit=max&auto=format&n=fqa23GjG0dFWAgwW&q=85&s=d8933253f0a1ff291e4e8450ec853011" type="video/mp4" data-path="images/legacy/sketchup/switching-accounts.mp4" />
</Frame>

Your Speckle accounts should be added via **[Speckle Manager](https://speckle.guide/user/manager)**.

You can switch between your accounts by clicking on your profile image and selecting it from the popup menu.
