# Set up your workspace (Unified Flow)

You can access it at any time by clicking Manager in the top-left navigation.

<figure><img src="/files/6zFKajmUstm2KVw80m4G" alt=""><figcaption></figcaption></figure>

### Getting started

When you first open the Manager Dashboard, you'll see a guided setup wizard with five steps. You can complete these in any order, or skip the wizard entirely and come back later.

#### Step 1: Set up roles

Roles control what each team member can do across your workspace. You'll find built-in roles ready to use, or you can create custom ones tailored to your team's structure. To configure roles:

1. Click Set up roles in the wizard, or go to Roles in the left sidebar under Settings.

<figure><img src="/files/CRfqLrqQkG1PmlBpXeUq" alt=""><figcaption></figcaption></figure>

2. Review the default roles and their permissions.

<figure><img src="/files/7dg4POtv1xG9pZR43t55" alt=""><figcaption></figcaption></figure>

3. Create custom roles if needed — give each a name, description, and select the permissions it should have.
4. You can set permission scopes to control access at a granular level (e.g. which projects a role can access).

<figure><img src="/files/lYnmEaUJ4yvDKt1yZkYk" alt=""><figcaption></figcaption></figure>

#### Step 2: Add your team

Invite team members so they can start working on projects.

1. Click Add your team in the wizard, or go to Users & Groups in the left sidebar.

<figure><img src="/files/qEHtJD9MCfhjpgFT278Z" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/mI2GEIRvx8nrGM7zwtD8" alt=""><figcaption></figcaption></figure>

2. Enter the person's email, set a temporary password (they can change it after logging in), and choose their organisation role (Editor, Admin or External).

<figure><img src="/files/5aI55460qyfkMPu1T3kl" alt=""><figcaption></figcaption></figure>

3. Assign roles to each of the added members.

<figure><img src="/files/WDoDl4s9GB1P0djTbw3z" alt=""><figcaption></figcaption></figure>

4. Optionally assign them to [groups](https://youtu.be/A71qmmiJBr0?si=8hqJeg4jjb0dl9re) or create a new group.

<figure><img src="/files/UOIg3eryDbRgGhlIz35n" alt=""><figcaption></figcaption></figure>

#### Step 3: Organize groups

Groups let you organize team members for easier project access management.

1. Go to Users & Groups in the left sidebar or click on New Group.

<figure><img src="/files/gEwh6NL8jFv6pf8jTdgd" alt=""><figcaption></figcaption></figure>

2. Create a group (e.g. "Research Team", "Programming Team").
3. Add members to groups. A user can belong to multiple groups.

<figure><img src="/files/VjRTuTAbQLjCWijv2Teu" alt=""><figcaption></figcaption></figure>

3. You can rename or delete groups at any time. Deleting a group does not remove the users from your workspace.

#### Step 4: Connect a platform

Connect your survey hosting platform so projects can sync directly.

1. Click Connect a platform in the wizard, or go to Integrations in the left sidebar.

<figure><img src="/files/d00hGodV9DankIhGd28y" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/xS2AVLMXP9J7WGL0hAot" alt=""><figcaption></figcaption></figure>

2. Choose your platform:

<figure><img src="/files/vzloPzgCFmga7yHSCnII" alt=""><figcaption></figcaption></figure>

* Forsta / Decipher: Enter your Decipher API credentials (domain and API key). Once connected, you'll be able to sync surveys and see the sync status on the Overview page.
* Confirmit: Enter your Confirmit base URL.
* Qualtrics: Enter your Qualtrics base URL.

<figure><img src="/files/vZuq1MOtab8pq4xOLA7E" alt=""><figcaption></figcaption></figure>

3. You can also set up API accounts under Integrations if your team needs programmatic access. Each account can have its own set of API keys.

<figure><img src="/files/z1tlEHdBCIwiiImvxUYS" alt=""><figcaption></figcaption></figure>

#### Step 5: Configure notifications

Set up how and when you receive notifications about project activity.

1. Go to Notifications in the left sidebar.
2. Configure your global preferences — choose whether you want in-app notifications, email, or both.
3. Fine-tune per notification type — you can enable or disable specific categories (e.g. project edits, sync failures, mentions).
4. Mark notifications as read individually or in bulk from the notification feed.

<figure><img src="/files/7sYq8LFE46QcmDOHkKCZ" alt=""><figcaption></figcaption></figure>

### Overview

<figure><img src="/files/eLJyStIMKsbGncmnHuHO" alt=""><figcaption></figcaption></figure>

The Overview page is your at-a-glance summary. It shows four key metrics as cards at the top, each with a sparkline trend and a comparison to the previous period:

* Active Projects — how many projects are currently active (not archived), with the change since last period.
* Team Members — how many people are in your workspace, with new additions highlighted.
* Generations — how many AI generations were run across all projects, with period-over-period comparison.
* Edits This Week — total edits (human + AI) across all projects, with trend.

You can switch the time window using the tabs in the top-right: 1 week, 2 weeks, 1 month, or 3 months. All metrics and trends adjust to the selected window\.Below the metric cards you'll see two panels:

#### Member Activity

A ranked list of team members showing how many projects each person contributed to during the selected period. Click View all to see the full team breakdown.

#### Decipher Sync Summary

If you've connected Forsta/Decipher, this panel shows the current state of your project syncs:

* Synced — projects that are successfully connected and up to date.
* Pending — projects where an initial sync is still in progress.
* Not connected — projects that haven't been linked to a Decipher survey yet.

Click View all to see per-project sync details.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.metaforms.ai/managers-dashboard/set-up-your-workspace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
