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

# Get started with a workspace

> Set up a Syncly workspace, understand roles and permissions, and manage members.

A **workspace** is where your team's Queries, analyses, dashboards, Collections, and members live in Syncly Social. Use separate workspaces to keep teams, brands, or clients apart.

## When to use it

* You're starting with Syncly Social.
* You want separate spaces for different teams, brands, or clients.
* You want to invite teammates to work on the same analyses and dashboards.
* You need to set the workspace's language and time zone.

## Before you start

* Sign in with your Syncly account.
* Anyone signed in can create a workspace and automatically becomes its **Admin**.
* What you can do in a workspace depends on your role: **Admin**, **Editor**, or **Viewer**.

## Roles and permissions

Syncly workspaces have three roles: Admin, Editor, and Viewer.

| What you can do | Viewer | Editor | Admin |
| :- | :-: | :-: | :-: |
| **View** Queries, posts, Social intelligence, Collections, and Dashboards | ✅ | ✅ | ✅ |
| **Export a dashboard to PDF** | ✅ | ✅ | ✅ |
| **See the XLSX export list and status** | ✅ | ✅ | ✅ |
| **Ask Hey Syncly questions** | ✅ | ✅ | ✅ |
| **Leave the workspace** | ✅ | ✅ | ❌ *(one Admin per workspace)* |
| **Create, edit, or delete Queries and their exclusions** | ❌ | ✅ | ✅ |
| **Mark or unmark posts as noise** | ❌ | ✅ | ✅ |
| **Change a post's sentiment** | ❌ | ✅ | ✅ |
| **Create, edit, or delete Social intelligence analyses and Views** | ❌ | ✅ | ✅ |
| **Create, edit, or delete Collections and their posts** | ❌ | ✅ | ✅ |
| **Create, edit, or delete Dashboards** | ❌ | ✅ | ✅ |
| **Manage Global trends email subscriptions** | ❌ | ✅ | ✅ |
| **Request, retry, and download XLSX exports** | ❌ | ✅ | ✅ |
| **View and regenerate invite codes** (Editor and Viewer codes) | ❌ | ✅ | ✅ |
| **Change member roles** (Editor ↔ Viewer) | ❌ | ❌ | ✅ |
| **Remove members** | ❌ | ❌ | ✅ |
| **Manage workspace settings and delete the workspace** | ❌ | ❌ | ✅ |
| **Create and delete API keys** | ❌ | ❌ | ✅ |

### Role details

* **Admin:** Each workspace has exactly one Admin, the person who created it. The Admin can do everything a Editor can, plus remove members, change roles between Editor and Viewer, manage all workspace settings, delete the workspace, and manage API keys. Because every workspace needs an Admin, the Admin can't leave or change their own role.
* **Editor:** Can do everything a Viewer can, plus create, edit, and delete Queries and their exclusions; mark noise; change sentiment; manage Social intelligence analyses and Views, Collections, and Dashboards; set up Global trends emails; request and download XLSX exports; and view or regenerate invite codes. Editors can leave the workspace at any time.
* **Viewer:** Can view Queries, posts, Social intelligence analyses, Collections, and Dashboards (including exporting a dashboard to PDF), and see the XLSX export list. Viewers can also ask Hey Syncly questions and use the answers, and can leave the workspace at any time.

## Invite members

Invite teammates from workspace settings or the member list.

* **Two invite codes:** Each workspace has a **Editor invite code** and a **Viewer invite code**.
* **Roles are set automatically:** Teammates get the role that matches the code they use.
* **Regenerating a code:** The old code stops working right away. Current members aren't affected.

## Manage your workspace

### 1. Create a workspace

1. Open the workspace menu.
2. Select to create a new workspace.
3. Enter a name.
4. Choose the time zone and language.
5. Save. You become the Admin and the new workspace opens.

### 2. Switch workspaces

1. Open the workspace selector at the top.
2. Review the workspaces you belong to.
3. Select one to switch.

### 3. Invite teammates

1. Open member management in workspace settings.
2. Copy the **Editor invite code** or **Viewer invite code**, depending on the role you want to give.
3. To replace a code (for example, if it was shared too widely), select **Regenerate**.
4. Send the code to your teammate.

### 4. Manage members and roles

1. Open the member list to see names, emails, and roles.
2. As the Admin, change roles between Editor and Viewer.
3. As the Admin, remove members who no longer need access.

### 5. Change workspace settings

1. Open workspace settings.
2. Edit settings such as the name, time zone, and language.
3. Save. Changes apply for everyone in the workspace.

### 6. Connect an AI assistant

Syncly MCP connects using the official server address (`https://mcp.syncly.app/mcp`) and your own Syncly sign-in. You don't need a separate link for each workspace. See [Connect Syncly MCP to an AI client](https://syncly-a76215af.mintlify.site/en/start/connect-mcp-clients.md).

## Frequently asked questions

### My invite code doesn't work

The code may have been typed incorrectly, or someone may have regenerated it. Ask your workspace Admin or a Editor for the latest Editor or Viewer code.

### I can't leave the workspace

Every workspace needs exactly one Admin, so the Admin can't leave or change their own role. To close the workspace, delete it in workspace settings, or contact support to transfer the Admin role. Editors and Viewers can leave at any time.

### I can't change a member's role

Only the Admin can change roles (Editor ↔ Viewer) or remove members. The Admin can't change their own role.

## Troubleshoot

| Symptom | What to check |
| :- | :- |
| Can't create a workspace | That you're signed in, the name isn't already used, and required fields are filled in |
| Can't see or regenerate invite codes | That you're a Editor or Admin |
| Can't see the member list | That you're a member of this workspace |
| Can't change roles or remove members | That you're the Admin, and that you're not trying to change your own role |
| Can't save settings or delete the workspace | That you're the Admin |

## Related features

* [Track brands, products, and topics with a Query](https://syncly-a76215af.mintlify.site/en/start/create-query.md)
* [Review collection results in Query detail](https://syncly-a76215af.mintlify.site/en/analysis/analyze-query-dashboard.md)
* [Connect Syncly MCP to an AI client](https://syncly-a76215af.mintlify.site/en/start/connect-mcp-clients.md)
* [Export posts to XLSX](https://syncly-a76215af.mintlify.site/en/share/export-posts.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.