> ## Documentation Index
> Fetch the complete documentation index at: https://www.magicpatterns.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Team Workspaces

> Invite team members, manage your brand context, and configure workspace settings.

Team Workspaces give your team a shared place to work together, manage members, share Design Systems and components, and centralize billing.

## Getting started

Go to [magicpatterns.com/settings/team](https://www.magicpatterns.com/settings/team) to manage your workspace. Only admins can manage the workspace; you can see who is the admin in the Team Members table under the Role column. You'll see:

* Team Members – Everyone in your workspace
* Subscription Plan – Your current plan (Starter, Business, or Enterprise)
* Billable Seats – How many paid seats you're paying for
* Available Seats – How many seats are free to assign

![Team Members table showing subscription overview and member list with Role column](https://cdn.magicpatterns.com/static/docs/team-members-table.png)

> [!TIP]
>
> You can invite unlimited team members. Free seats are included at no cost.
> Only paid seats count toward your bill.

## Understanding seats

A seat is a paid spot on your workspace plan. Each seat gets its own monthly credits and full access to generate designs. You pay for the number of seats you need.

* Paid seat – Full access, uses credits, counts toward your bill
* Free seat – In the workspace at no cost, free monthly credits for generation

When you invite someone, they join with a Free seat by default. To give them full access, add a paid seat first (if needed), then assign it to them. Only admins can invite and manage members.

## Workspace size and plans

Each plan has a limit on the number of paid seats:

* Starter: Up to 10 paid seats
* Business: 11 or more paid seats
* Enterprise: 10 paid seats minimum

If your workspace grows beyond 10 paid seats, you'll need to upgrade to Business or Enterprise. Free seats don't count toward this limit.

## Common scenarios

> [accordion] I need to add a teammate with full access
>
> 1. Go to [magicpatterns.com/settings/team](https://www.magicpatterns.com/settings/team)
> 2. If you're out of seats, click Add more seats first and complete the payment
> 3. Click Invite and enter their email
> 4. Once they've joined, click the ... next to their name
> 5. Click Upgrade to assign them a paid seat

> [accordion] Someone left the team. I want to give their seat to someone else
>
> Use Reassign Seat to move a paid seat from one person to another:
>
> 1. Click the ... next to the member who is leaving
> 2. Click Reassign Seat
> 3. Select the team member who should receive the seat
>
> Credits already used on that seat transfer to the new member. The person who
> had the seat stays in the workspace but moves to a Free seat. The person
> receiving the seat gets it right away.

> [accordion] I want to remove someone's seat but keep them in the workspace
>
> Use Cancel Seat when you want to free up a seat but keep the person in the
> workspace:
>
> 1. Click the ... next to the member
> 2. Click Cancel Seat
> 3. Their seat is marked for cancellation and frees up at the end of your
>    billing cycle
> 4. Until then, they keep full access. After the billing cycle ends, they
>    remain in the workspace with a Free seat
>
> You cannot cancel your own seat. Use Manage Plan to change or cancel the
> workspace subscription instead.

> [accordion] I need to remove someone from the workspace entirely
>
> 1. Click the ... next to the member
> 2. Click Remove
> 3. They are removed from the workspace

> [accordion] I changed my mind about cancelling a seat
>
> 1. Click the ... next to the member whose seat is pending cancellation
> 2. Click Undo Cancellation
> 3. The seat stays active

> [accordion] I'm out of seats. How do I add more?
>
> 1. Go to [magicpatterns.com/settings/team](https://www.magicpatterns.com/settings/team)
> 2. Click Add more seats
> 3. Choose how many seats you need
> 4. Complete the payment
>
> Seats are prorated. You pay for the remainder of your billing cycle.

> [accordion] I have too many seats. How do I reduce them?
>
> Cancel seats for members who no longer need full access. Each cancelled seat
> frees up at the end of your billing cycle. You cannot reduce seats below the
> number of members who currently have active seats.

> [accordion] I want to change our plan (upgrade or downgrade)
>
> 1. Go to [magicpatterns.com/settings/subscription](https://www.magicpatterns.com/settings/subscription) or [magicpatterns.com/settings/team](https://www.magicpatterns.com/settings/team)
> 2. Click Manage Plan
> 3. Select a new plan and complete the change in the payment portal
>
> See [Credits and Billing](https://www.magicpatterns.com/docs/documentation/get-started/credits-and-billing.md)
> for how upgrades, downgrades, and prorating work.

## When to use a Team Workspace

Team Workspaces work well when you:

* Work with multiple designers or developers on the same product
* Need a consistent brand across many pages or projects
* Share design systems, components, or templates
* Want one person to manage billing for the whole team

Once teammates are in the workspace, opening the same design or canvas puts you in a [live multiplayer session](https://www.magicpatterns.com/docs/documentation/collaboration/live-multiplayer.md), with shared chat, generations, and (on the canvas) live cursors and shared selections.

## Roles

* Admin – Can invite members, add seats, manage plans, upgrade or downgrade members, remove members, and change roles
* Member – Can use the workspace based on their seat; cannot manage billing or other members

## Usage reporting

**Business** and **Enterprise** workspaces include Usage Reports at [magicpatterns.com/settings/usage-reports](https://www.magicpatterns.com/settings/usage-reports). There you can track workspace adoption, compare activity with a team leaderboard, and review time saved. Workspaces on other plans see an upgrade prompt until you move to Business or Enterprise.

![Unlock Usage Reporting modal on the Usage Reports dashboard](https://cdn.magicpatterns.com/uploads/jcHU4QviYhREXQAGjYWm5P/usage-report.png)

## Moving files between workspaces

You can move designs between workspaces directly from the dashboard. Right-click on any file to see the option to move it to a different workspace.

![Right-click on a file to move it between workspaces](https://cdn.magicpatterns.com/uploads/cCfwJZdrt33DxMB91dGGDE/right-click-to-change-files.png)

This is useful when you need to:

* Transfer a design from your personal workspace to a team workspace
* Reorganize designs between different team workspaces
* Move completed work to a shared workspace for collaboration

## SSO and SCIM

SSO, SCIM, and auto-join are available for team workspaces. SSO is self-serve
and available on Business plans and Enterprise plans. SCIM is available on
Enterprise plans. See [SSO and SCIM setup](https://www.magicpatterns.com/docs/documentation/enterprise/sso-scim-setup.md)
for details.


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