> ## Documentation Index
> Fetch the complete documentation index at: https://magicpatterns.mintlify.site/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.
</Tip>

## 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, 100 credits per month 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

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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](/documentation/get-started/credits-and-billing)
    for how upgrades, downgrades, and prorating work.
  </Accordion>
</AccordionGroup>

## 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](/documentation/collaboration/live-multiplayer), 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](/documentation/enterprise/sso-scim-setup)
for details.
