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

# Collaboration

How Rhino Sync shares one model between teammates, the parts of a session and the everyday workflow.

Working together in Rhino Sync comes down to three buttons: **Reload** brings in your teammates' work, **Send** shares yours in seconds, and **Synchronize** saves everyone's into the shared file. This page shows how they fit together.

## The parts of a session

| Part                  | What it is                                                                             |
| --------------------- | -------------------------------------------------------------------------------------- |
| **Central file**      | The shared `.3dm`, on a network drive or in Google Drive, OneDrive, Dropbox or Egnyte. |
| **Local copy**        | Your copy of the central file. You always work in it.                                  |
| **Rhino Sync server** | Runs the session: who is in it, who holds what, the chat and unsaved quick changes.    |
| **Session**           | Everyone on the same central file. The first to click **Collaborate** starts it.       |

## What each button does

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-bb70d6479e37e6de48a9136268b8f34118a75324%2Fmock-flow.png?alt=media" alt="Synchronize saves your edits to the central file and Reload brings them to teammates. With quick changes, Send shares your edits through the Rhino Sync server, Reload picks them up and Synchronize saves them to the central file." width="794"><figcaption></figcaption></figure>

| Button                                                                         | What it does                                              | Central file (`.3dm`) | Your objects |
| ------------------------------------------------------------------------------ | --------------------------------------------------------- | --------------------- | ------------ |
| [**Reload**](https://sync.wiki.mksdtech.com/collaboration/reload.md)           | Brings in teammates' changes.                             | Not written.          | Stay yours.  |
| [**Send**](https://sync.wiki.mksdtech.com/collaboration/quick-changes.md)      | Shares your edits in seconds. Only with quick changes on. | Not written.          | Released.    |
| [**Synchronize**](https://sync.wiki.mksdtech.com/collaboration/synchronize.md) | Reloads, then saves your changes and all quick changes.   | **Saved**.            | Released.    |
| Rhino's **Save**                                                               | Saves your local copy only.                               | Not written.          | Stay yours.  |

{% hint style="info" %}
**Synchronize is the only way your work reaches the central `.3dm`.**
{% endhint %}

## Two ways to work

A session runs with or without [quick changes](https://sync.wiki.mksdtech.com/collaboration/quick-changes.md). You choose when you start or join, for everyone. They are on by default.

{% tabs %}
{% tab title="With quick changes" %}
Best for large models, where saving the central file is slow.

1. **Collaborate** with **Quick changes** ticked. See [Collaborate](https://sync.wiki.mksdtech.com/collaboration/collaborate.md).
2. **Edit.** Objects you change are reserved for you.
3. **Send** whenever teammates should see your work. It frees your objects.
4. **Reload** to get teammates' changes.
5. **Synchronize** regularly, and always before you stop for the day.
6. **End Collaborate.** See [End Collaboration](https://sync.wiki.mksdtech.com/collaboration/end-collaboration.md).
   {% endtab %}

{% tab title="Normal session" %}
Every share saves the central file.

1. **Collaborate** with **Quick changes** unticked.
2. **Edit.** Objects you change are reserved for you.
3. **Reload** often.
4. **Synchronize** to share your changes and free your objects.
5. **Synchronize, then End Collaborate.**
   {% endtab %}
   {% endtabs %}

Teammates without Rhino can follow the session in the [Web Viewer](https://sync.wiki.mksdtech.com/collaboration/web-viewer.md), and [AI agents](https://sync.wiki.mksdtech.com/collaboration/ai-agents.md) can join it to model on request.

## Where the session stands

The status card under the toolbar in the **Sync** panel shows where the session stands.

| Icon           | Shows                                                    |
| -------------- | -------------------------------------------------------- |
| ⚡              | Quick changes not saved yet. **Synchronize** saves them. |
| Download arrow | Teammates' changes to **Reload**.                        |
| Upload arrow   | Your own changes not sent or synchronized yet.           |
| Disk           | When the central file was last saved, and by whom.       |

While anyone synchronizes, the counts give way to **Saving to central file…**.

### In a normal session

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-7a3f52abe0a9b8e6c61f7065a9d6db2f86be2d3f%2Fmock-status-card-normal.png?alt=media" alt="Status card in a normal session: 12 changes to reload, 3 of yours to synchronize, central file saved at 14:02 by Mauro" width="332"><figcaption></figcaption></figure>

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-8cdc4454a502a1ea92163363557967fed2aacb68%2Fmock-status-card-normal-saving.png?alt=media" alt="Status card while the central file is being saved" width="332"><figcaption></figcaption></figure>

### With quick changes on

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-8015df617a1c0664c4a2f536961ea1902b297a24%2Fmock-status-card-quick.png?alt=media" alt="Status card with quick changes: 48 quick changes not saved, 12 to reload, 3 of yours not sent" width="332"><figcaption></figcaption></figure>

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-9eca2435de3227ab02c7c6aff4501fcc1b09fb76%2Fmock-status-card-quick-saving.png?alt=media" alt="Status card while quick changes are being saved to the central file" width="332"><figcaption></figcaption></figure>

## How editing works

An object you change stays reserved for you until you synchronize or send. If a teammate holds it, or changed it since your last reload, Rhino Sync undoes your change and tells you why. See [Edit conflicts](https://sync.wiki.mksdtech.com/collaboration/edit-conflicts.md).

Hiding, locking and isolating are personal and reserve nothing. See [What Rhino Sync synchronizes](https://sync.wiki.mksdtech.com/reference/what-is-synchronized.md).

## Rules for a smooth session

* **Synchronize at least every 24 hours.** After that you have to start the session again. A banner warns you 30 minutes before.
* **Use the same version.** Everyone runs the same Rhino Sync version.
* **Use a unique user name.** Set it in [Settings](https://sync.wiki.mksdtech.com/reference/settings.md).
* **Don't open the central file in Rhino.** It blocks everyone's synchronization.

{% hint style="warning" %}
Closing with changes not in the central file asks first: **Sync and close** saves them, **Close without syncing** drops them.
{% endhint %}

## In this section

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/rhino-sync-panel.md"><strong>Rhino Sync Panel</strong></a></td><td>A tour of every button and area.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/collaborate.md"><strong>Collaborate</strong></a></td><td>Start or join a session.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/reload.md"><strong>Reload</strong></a></td><td>Get your teammates' changes.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/synchronize.md"><strong>Synchronize</strong></a></td><td>Save your changes into the central file.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/quick-changes.md"><strong>Quick Changes</strong></a></td><td>Share edits in seconds between synchronizes.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/end-collaboration.md"><strong>End Collaboration</strong></a></td><td>Leave the session.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/edit-conflicts.md"><strong>Edit conflicts</strong></a></td><td>What happens when an object is in use.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/users-and-colours.md"><strong>Users and colours</strong></a></td><td>See who is online and who holds what.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/live-previews.md"><strong>Live Previews</strong></a></td><td>Watch teammates' edits before they synchronize.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/sync-chat.md"><strong>Rhino Sync Chat</strong></a></td><td>Message your team, share points and views.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/ai-agents.md"><strong>AI Agents</strong></a></td><td>Ask Claude agents to model alongside you.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/web-viewer.md"><strong>Web Viewer</strong></a></td><td>Follow the session in a browser, without Rhino.</td></tr><tr><td><a href="https://sync.wiki.mksdtech.com/collaboration/collaboration-status.md"><strong>Collaboration Status</strong></a></td><td>Check your session at a glance.</td></tr></tbody></table>
