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

# Create a team workspace in DevUps

> Walk through creating a new DevUps team workspace, completing your Stripe subscription, uploading a team avatar, and renaming the team after setup.

A team workspace gives you a shared environment where you can invite colleagues, publish team-visible learning paths, and view analytics across all members. Creating a team takes a few minutes and requires completing a subscription through Stripe.

## Create a new team

<Steps>
  <Step title="Open the team creation page">
    Navigate to **/team** in the app. In the top-right area of the page, click **New Team**. Alternatively, go directly to `/team/create`.
  </Step>

  <Step title="Enter a team name">
    Type a name for your team in the **Team Name** field. Team names must be unique across all DevUps team workspaces — if the name is already taken, you'll see an error and need to choose a different one.

    You can also add an optional **Description** to help members understand the team's purpose.
  </Step>

  <Step title="Continue to payment">
    Click **Continue to Payment**. DevUps validates that the team name is available before proceeding.
  </Step>

  <Step title="Complete your subscription">
    Review the subscription details on the payment step, then click **Subscribe - \$5/month**. You'll be taken to Stripe to complete the payment securely.

    <Note>
      Stripe checkout opens in a new tab. Once payment is confirmed, this page detects the completed payment automatically and redirects you to your new team.
    </Note>
  </Step>

  <Step title="Team setup completes">
    After payment is confirmed, DevUps creates your team workspace and sets you as the **Owner**. You're redirected to `/team`, where you can start inviting members and creating learning paths.
  </Step>
</Steps>

## Upload a team avatar

Owners and admins can add a visual identity to the team with an avatar image.

<Steps>
  <Step title="Go to your team page">
    Navigate to **/team** while the team workspace is selected in the sidebar.
  </Step>

  <Step title="Hover over the avatar">
    Hover your cursor over the team avatar in the top-left area of the page header. A camera icon appears in the center of the avatar.
  </Step>

  <Step title="Click the camera icon and select a file">
    Click the camera icon to open the file picker. Select an image file from your device.

    <Warning>
      Images must be 2 MB or smaller. Only image file types are accepted (JPEG, PNG, GIF, WebP, etc.).
    </Warning>
  </Step>

  <Step title="Wait for the upload to complete">
    The avatar updates automatically once the upload finishes. You'll see a confirmation message in the bottom-right corner of the screen.
  </Step>
</Steps>

## Rename a team

Owners can rename a team workspace at any time. Admins can also rename the team.

<Steps>
  <Step title="Open the rename dialog">
    Navigate to **/team** and click the **pencil icon** next to the team name in the page header. The rename dialog appears.
  </Step>

  <Step title="Enter the new name">
    Type the new team name. Names must be unique — the system checks for conflicts before saving.
  </Step>

  <Step title="Save">
    Click **Save**. The team name updates throughout the app, including the sidebar workspace switcher.
  </Step>
</Steps>

<Note>
  The pencil icon only appears for non-personal team workspaces. Your personal workspace cannot be renamed.
</Note>