# Adding Members to a Workspace

In Mosaic, workspaces are owned and managed by their creators. The owner of a shared workspace adds members one at a time by email, and assigns each one a role.

## Who can add members

Only the workspace **Owner** can invite new members or change roles. Editors and Viewers cannot.

A workspace can have more than one owner. Owners can promote an existing Editor to Owner if you want a co-pilot.

## Steps

{% stepper %}
{% step %}

#### Open the workspace

From the sidebar, switch to the workspace you want to add a member to. You must be the **Owner**.
{% endstep %}

{% step %}

#### Open Workspace settings → Members

The settings entry sits next to the workspace name in the sidebar.
{% endstep %}

{% step %}

#### Add a member by email

Click **Add member**. Enter the teammate's work email address. Pick the role:

* **Editor** - full create / edit / run / embed / DAX
* **Viewer** - read-only

Click **Add**.
{% endstep %}

{% step %}

#### They see the workspace on next sign-in

The member opens Mosaic and sees the shared workspace in their sidebar. If they haven't signed in to Mosaic before, their account is provisioned automatically by Microsoft Entra.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Members must belong to your Microsoft 365 tenant.** Mosaic does not currently support external (guest / B2B) collaboration. Invitees who don't have a Microsoft Entra account in your tenant cannot sign in.
{% endhint %}

## Changing a member's role

Open **Workspace settings → Members**, find the member, click the role dropdown next to their name, and pick a different role. Changes take effect immediately.

## Removing a member

In **Workspace settings → Members**, click the kebab (⋮) next to the member and choose **Remove**. They lose access to the workspace immediately. Their personal workspace and other workspaces they belong to are not affected.

{% hint style="info" %}
Removing a member is a Mosaic-side action only. It does not change anything in Microsoft Entra ID or in Power BI. If you also want to revoke their Power BI access, that's a separate step in Power BI itself.
{% endhint %}

## What's next

* [Workspace Roles](/mosaic/user-access/workspace-roles.md) — what each role can do, in detail


---

# 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://docs.aidi.ai/mosaic/user-access/adding-members.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.