# Collaboration

- Human documentation: [https://docs.univer.ai/guides/boards/features/collaboration](https://docs.univer.ai/guides/boards/features/collaboration)

- Agent Markdown: [https://docs.univer.ai/guides/boards/features/collaboration.md](https://docs.univer.ai/guides/boards/features/collaboration.md)

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.0.0-rc.0`

- Source: [boards/features/collaboration.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/boards/features/collaboration.mdx)

---

#### Package metadata

```json
{
  "preset": [],
  "plugins": [
    {
      "client": "@univerjs-pro/collaboration"
    },
    {
      "client": "@univerjs-pro/collaboration-client",
      "facade": "@univerjs-pro/collaboration-client/facade",
      "locale": "@univerjs-pro/collaboration-client/locale/en-US"
    },
    {
      "client": "@univerjs-pro/collaboration-client-ui",
      "facade": "@univerjs-pro/collaboration-client-ui/facade",
      "locale": "@univerjs-pro/collaboration-client-ui/locale/en-US",
      "style": "@univerjs-pro/collaboration-client-ui/lib/index.css"
    }
  ],
  "server": true
}
```

Let multiple users edit the same board and see each other's changes. Complete [collaboration integration](https://docs.univer.ai/server/collaboration/browser-integration.md) for the backend, authentication, permissions, and storage, then configure the [license](https://docs.univer.ai/server/license.md).

## Configure and load a document

Add Collaboration Client configuration to your existing Boards editor using the [Office quick start](https://docs.univer.ai/server/collaboration/quick-start.md). That example uses Sheets; your backend must create and persist a Boards document and return its ID to the browser.

```ts
import '@univerjs-pro/boards/facade'
import '@univerjs-pro/collaboration-client/facade'

const document = await univerAPI.getCollaboration().loadBoardAsync('your-document-id')
if (!document) throw new Error('Document could not be loaded')
```

Use the same ID when reopening or sharing the document. Do not create a local blank document instead of loading the server document.

## Verify synchronization and permissions

Open the same ID in two independent browser sessions. Edit text or move an element in one session and check the other. Verify that content survives page reloads, reconnections, and a service restart. Use viewer and unauthorized accounts to verify that the server rejects forbidden writes and reads.

[Edit history](https://docs.univer.ai/guides/boards/features/edit-history.md) and [Import and export](https://docs.univer.ai/guides/boards/features/import-export.md) require separate configuration; collaboration does not enable them automatically.
