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

# Team Plan

> Configure CodeBanana Team Plan for organizations with customizable seats, shared token pool billing, seat-based VM configurations, flexible validity periods, usage alerts, member limits, model usage limits, renewals, enterprise payment support, and visibility into tokens, limits, and expiration timelines.

## **What is Team Plan**

Team Plan is a flexible team subscription for organizations in CodeBanana.

It allows teams to configure and manage:

* Customizable seat counts
* Per-seat VM configurations
* A shared token pool for team-wide usage

All billing and usage management are handled at the organization level, giving admins centralized control over seats, compute, token consumption, and member limits.

***

## **Get Team Plan**

Team Plan can be purchased from **Pricing → Team Plan**.

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/0xpD-XQG85gOEndD/images/0418-teamplan-pricing.png?fit=max&auto=format&n=0xpD-XQG85gOEndD&q=85&s=ed53e0667a215474dea31657ab0e103c" alt="0418 Teamplan Pricing" width="2550" height="1406" data-path="images/0418-teamplan-pricing.png" />
</Frame>

### **Custom seats and shared token pool**

Team Plan supports flexible purchase configuration based on actual team needs:

* Seat quantity can be selected freely
* Minimum purchase starts from **1 seat**
* The token pool amount can be customized
* No minimum token pool amount is required
* A token pool of **\$0** is allowed
* The token pool is shared across the entire team

### **Validity period**

Team Plan supports multiple validity options:

* **1 month**
* **3 months**
* **6 months**
* **12 months**

### **Included token quota**

Each seat includes a fixed amount of token quota:

* **\$25 / seat / month**

Team Plan usage is also managed through member-level limits and the shared organization token pool.

### **VM tiers**

Each seat can be configured with one of three VM tiers:

* **2 vCPU / 4GB** — **\$45 / seat / month**
* **4 vCPU / 8GB** — **\$65 / seat / month**
* **8 vCPU / 16GB** — **\$105 / seat / month**

<Note>
  Team Plan seat pricing follows the same VM tier structure as Personal Plan.
</Note>

***

## **Usage Entry**

After purchasing Team Plan, admins can manage seats, token usage, and members from **Avatar → Usage**.

This is the main entry for:

* Team seat usage
* Token pool balance and consumption
* Member-level usage and limits
* Renewals
* Additional seat purchase
* Token top-up

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/0xpD-XQG85gOEndD/images/0418-teamplan-entry.png?fit=max&auto=format&n=0xpD-XQG85gOEndD&q=85&s=b4aaa0d91ab39d256be45662366d6ed0" alt="0418 Teamplan Entry" width="2880" height="1390" data-path="images/0418-teamplan-entry.png" />
</Frame>

***

## **Usage Management**

The **Usage** page provides both team-level and member-level visibility.

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/SVq3FdpEvghEV6aa/images/0520-teamplan-usagemanage.png?fit=max&auto=format&n=SVq3FdpEvghEV6aa&q=85&s=343fea0fc6c7c6bc12fa4c7cf07ca5c7" alt="0418 Teamplan Usermanage" width="2062" height="1386" data-path="images/0520-teamplan-usagemanage.png" />
</Frame>

### **Usage Alerts**

CodeBanana provides usage alerts for Team Plan across both member-level limits and the shared organization token pool.

**Member on-demand limit**

* A reminder is shown when a member’s remaining on-demand limit is **10% or less and no more than \$10**
* Each user receives this reminder at most **once per day**
* The reminder is triggered independently for each user
* The reminder asks the user to contact the organization owner or admin before usage is interrupted
  ***Reminder text***
  > You're almost at your on-demand limit ({usedPct}% used). Reach out to your organization owner or admin to increase your limit before usage is interrupted.

**Shared organization token pool**

* A reminder is shown when the shared token pool balance falls below **10%**
* This reminder is intended for the organization owner or admin so the pool can be topped up in time
  ***Reminder text***
  > Your organization's shared token budget is almost depleted — \${remaining} left. Please contact your organization owner or admin to top up soon and keep your team running smoothly.

### **Team usage (Admin view)**

Admins can view and manage:

* Seats used / total seats
* Shared token pool consumption
* Remaining token pool balance
* **Add Seats**
* **Top Up** for the token pool

Current limitation:

* Additional seats currently support only the **same VM tier** as the original Team Plan purchase
* More flexible mixed seat top-up modes will be supported in later iterations

Validity rule:

* Additional seats and token top-ups follow the same expiration date as the current Team Plan period
* If a seat is added during an active Team Plan period, both the added seat cost and its included token quota are prorated based on the remaining time in that period

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/SVq3FdpEvghEV6aa/images/0520-teamplan-addseat.png?fit=max&auto=format&n=SVq3FdpEvghEV6aa&q=85&s=46cdfd1a56c06b36b1424f82d6d5993a" alt="0418 Teamplan Addseat" width="2810" height="1364" data-path="images/0520-teamplan-addseat.png" />
</Frame>

### **Personal usage (Member view)**

Each member can view their own usage details, including:

* Personal token consumption amount
* Current token limit status
* Current VM configuration

***

## **Admin Controls**

Organization owners and admins can manage Team Plan configuration and usage.

### **Add members to Team Plan**

<Steps>
  <Step title="Go to Usage">
    Click the avatar in the top-right corner.

    Select **Usage** from the dropdown to enter the usage management page.

    <Frame>
      <img src="https://mintcdn.com/gen-d40df51d/0xpD-XQG85gOEndD/images/0418-teamplan-entry.png?fit=max&auto=format&n=0xpD-XQG85gOEndD&q=85&s=b4aaa0d91ab39d256be45662366d6ed0" alt="Teamplanstep1" width="2880" height="1390" data-path="images/0418-teamplan-entry.png" />
    </Frame>
  </Step>

  <Step title="Members & Quotas">
    Switch to the **Members & Quotas** tab.
  </Step>

  <Step title="Click Add Members">
    Click the blue **Add Members** button to open the member selection modal.

    <Frame>
      <img src="https://mintcdn.com/gen-d40df51d/SVq3FdpEvghEV6aa/images/0520-teamplan-step3.png?fit=max&auto=format&n=SVq3FdpEvghEV6aa&q=85&s=a5dd2bc0c1164e5bbc8333c9f0667860" alt="Teamplanstep3" width="2294" height="1264" data-path="images/0520-teamplan-step3.png" />
    </Frame>
  </Step>
</Steps>

Admins can add members into Team Plan within the range of already purchased seats.

* Members must already belong to the organization
* Members can be selected directly from organization contacts
* Seats are assigned within the currently purchased quota

<Info>
  Before adding members to Team Plan, users must first join the organization. Only after the admin approves the request can seats be assigned.
</Info>

<Card title="How to join an Organization?" icon="arrow-right-long" href="/documentation/teams/org" />

### **Model usage limits**

Team Plan admins can restrict which AI models each team member is allowed to use, giving the organization more precise control over model usage and cost.

**Where to configure**

* Go to **Usage → Members & Quotas**
* Find the **Models** column in the member table
* Set model access for each member individually, or apply restrictions in bulk

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/SVq3FdpEvghEV6aa/images/0520-teamplan-modellimite-overview.png?fit=max&auto=format&n=SVq3FdpEvghEV6aa&q=85&s=ec66a91fe10605f6f228c790dc45bd29" alt="0418 Teamplan Modellimite Overview" width="2294" height="1264" data-path="images/0520-teamplan-modellimite-overview.png" />
</Frame>

**Per-member model limits**

* Admins can open the **Models** selector for a specific member
* Each member can be set to:
  * **All** — all available models
  * **Selected models only** — only the checked models can be used
* Any model that is not selected will be unavailable to that member

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/SVq3FdpEvghEV6aa/images/0520-teamplan-singlemodel.png?fit=max&auto=format&n=SVq3FdpEvghEV6aa&q=85&s=4533f8ed85374f7226da58ec6145602e" alt="0418 Teamplan Modellimite Single" width="2294" height="1264" data-path="images/0520-teamplan-singlemodel.png" />
</Frame>

**Bulk model limits**

* Admins can select multiple members or use **Select All**
* After selecting members, admins can apply the same model access rules in one action
* This makes it easier to manage model permissions across larger teams

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/SVq3FdpEvghEV6aa/images/0520-teamplan-batchmodel.png?fit=max&auto=format&n=SVq3FdpEvghEV6aa&q=85&s=cdc5ea4289fc65ec82d7d60871cc18b3" alt="0520 Teamplan Batchmodel" width="2294" height="1264" data-path="images/0520-teamplan-batchmodel.png" />
</Frame>

**Filtering and visibility**

* The **Model Limits** filter at the top of **Members & Quotas** helps admins quickly identify which members already have restricted model access
* Skill and project usage remain visible, but model availability is limited based on the admin’s configuration

**Restriction scope**

* Model limits apply at the **member level**
* If a restricted member creates a project, everyone in that project will only be able to use the models allowed under that member’s restriction
* Unavailable models will appear disabled in the model selector

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/D5RoKD0ZduAeypkO/images/0418-teamplan-modellimit-result.png?fit=max&auto=format&n=D5RoKD0ZduAeypkO&q=85&s=564a670e9da72a59861fbdd703dd917b" alt="0418 Teamplan Modellimit Result" width="2876" height="1372" data-path="images/0418-teamplan-modellimit-result.png" />
</Frame>

### **Modify member plans**

Admins can update:

* Monthly token usage limits
* VM configuration
* Team Plan membership

**Limit controls**

* Members can only use token resources within the configured monthly limit
* Usage beyond the limit will be handled according to the current Team Plan limit and shared pool settings

**VM upgrades**

* VM upgrades are supported
* Changes take effect immediately

If the shared token pool has sufficient balance:

* Upgrade costs can be deducted from the token pool
* Additional seat costs can also be deducted from the token pool

**VM downgrades**

* VM downgrades are **not currently supported**

**Remove member**

* Team Plan members can be removed by the admin
* Removed seats can be reassigned to other members later within the purchased seat quota

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/0xpD-XQG85gOEndD/images/0418-teamplan-remove-editlimit.png?fit=max&auto=format&n=0xpD-XQG85gOEndD&q=85&s=05cb26cee250b9efa3aea873e77014c3" alt="Addteamplanmember" width="2492" height="1382" data-path="images/0418-teamplan-remove-editlimit.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/0xpD-XQG85gOEndD/images/0418-teamplan-upgradeVm.png?fit=max&auto=format&n=0xpD-XQG85gOEndD&q=85&s=dc15641599d7564108b49dea84fd5756" alt="Chang Vm" width="2294" height="1264" data-path="images/0418-teamplan-upgradeVm.png" />
</Frame>

**Billing management**

* All invoices are available in **Personal Center → Billing**

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/xR-espKycqAN8zPt/images/teamplanbill.png?fit=max&auto=format&n=xR-espKycqAN8zPt&q=85&s=fba15c9871d8f1741205a73b6640773a" alt="Teamplanbill" width="2294" height="1264" data-path="images/teamplanbill.png" />
</Frame>

***

## **Renewal**

Team Plan supports renewal before expiration.

Admins can renew the plan directly from the **Usage** page by clicking **Renew**.

This allows teams to continue using their seats and token pool without interruption

***

## **Enterprise Payment**

Team Plan also supports enterprise offline payment for contracted customers.

This option is designed for enterprise clients who do not manage purchases directly from the frontend.

For enterprise payment support, users should contact the CodeBanana team.

***

## **Visibility of Time Information**

Team Plan provides visibility into expiration and reset timelines.

<Frame>
  <img src="https://mintcdn.com/gen-d40df51d/1clhMHmpLAwIV5mj/images/05201-teamplanreset.png?fit=max&auto=format&n=1clhMHmpLAwIV5mj&q=85&s=16abaf53602e49bffc3e7b7faf2b82b7" alt="0520 Teamplan Reset" width="2062" height="1386" data-path="images/05201-teamplanreset.png" />
</Frame>

### **Owner can view**

* Team Plan seat expiration time
* Token pool expiration time
* Reset time for member on-demand limits

### **Member can view**

* Their own on-demand limit reset time

### **Everyone can view**

* The time when a member was added to Team Plan
* This is shown in the **Added** column of **Members & Quotas**

***

## **What’s Included**

Team Plan includes the following benefits:

* **\$25 token quota / seat / month**\
  Each seat includes a fixed monthly token quota
* **Flexible Seat Management**\
  Admins can manage Team Plan members at any time, and later add seats or top up the token pool
* **Team Usage Limit Controls**\
  Admins can set monthly token usage limits for members to better control spending
* **Custom VM Configurations**\
  Member VM configurations can be upgraded as needed
* **Top up anytime, use on-demand**\
  The token pool can be recharged at any time, with no minimum threshold
* **Shared On-Demand Token Usage**\
  Team members share a common token resource pool for more flexible team-level usage allocation

***

## **Transition Note**

The new Team Plan replaces the previous version.

Existing Team Plan users are not affected by the transition. They can continue using their current Team Plan benefits until those benefits expire or are fully used.

***

## FAQs

Answers to common questions about Team Plan.

<AccordionGroup>
  <Accordion title="Where can I purchase Team Plan?">
    Team Plan can be purchased from **Pricing → Team Plan**.
  </Accordion>

  <Accordion title="Can I choose my own seat count when purchasing Team Plan?">
    Yes. Team Plan supports customizable seat counts, starting from a minimum of **1 seat**.
  </Accordion>

  <Accordion title="What validity periods are available for Team Plan?">
    Team Plan supports **1, 3, 6, and 12 months**.
  </Accordion>

  <Accordion title="Does the token pool have a minimum top-up amount?">
    No. The token pool amount is fully customizable, and **\$0** is allowed.
  </Accordion>

  <Accordion title="Is the token pool shared across the team?">
    Yes. The token pool is shared across all members in the Team Plan and can be used on demand.
  </Accordion>

  <Accordion title="What happens when the included token quota is exhausted?">
    Team Plan usage can continue according to the current organization token pool and member limit configuration.
  </Accordion>

  <Accordion title="Can different VM configurations be assigned to different members?">
    Yes. Each seat can be configured independently, and admins can also upgrade VM configurations later for individual members.
  </Accordion>

  <Accordion title="Can VM configurations be downgraded?">
    No. VM upgrades are supported, but downgrades are currently unavailable.
  </Accordion>

  <Accordion title="Can admins add more seats later?">
    Yes. Admins can use **Add Seats** from the Usage page. At the moment, additional seats must use the same VM tier as the original purchase.
  </Accordion>

  <Accordion title="What happens if I add a seat in the middle of an active Team Plan period?">
    If you add a seat during an active Team Plan period, the added seat will follow the same expiration date as the current Team Plan.

    Both the additional seat cost and the included token quota are **prorated based on the remaining time** in the current period.

    For example, if your Team Plan runs from **June 1 to June 30** and you add a seat on **June 15**, the added seat will expire on **June 30**, and both the seat fee and the included token quota will be calculated proportionally for the remaining period.
  </Accordion>

  <Accordion title="Can admins top up the token pool later?">
    Yes. Admins can use **Top Up** from the Usage page to recharge the shared token pool at any time.
  </Accordion>

  <Accordion title="Can seat upgrades or VM upgrades be paid from the token pool?">
    Yes. If the shared token pool has sufficient balance, additional seat costs and member VM upgrade costs can be deducted from the token pool.
  </Accordion>

  <Accordion title="How do admins add members to Team Plan?">
    Admins can add members from **Usage → Members & Quotas**, as long as the members are already in the organization and there are available purchased seats.
  </Accordion>

  <Accordion title="How are member token limits used in Team Plan?">
    Team Plan supports member-level token limits so organizations can control usage more precisely. When a member approaches their configured on-demand limit, CodeBanana may show a reminder based on the current warning rules. Limit handling and available usage also depend on the organization’s shared token pool configuration.
  </Accordion>

  <Accordion title="Can admins restrict which AI models team members can use?">
    Yes. In **Usage → Members & Quotas**, admins can configure model access for each member through the **Models** column. Members can be allowed to use all models or only a selected set. If a restricted member creates a project, everyone in that project will only be able to use the models allowed under that member’s restriction.
  </Accordion>

  <Accordion title="When will Team Plan show usage warnings?">
    Team Plan uses different warning rules for different types of usage.

    * A member receives a reminder when their remaining on-demand limit is **10% or less and no more than \$10**
    * The organization owner or admin receives a reminder when the shared token pool balance falls below **10%**
  </Accordion>

  <Accordion title="Where can I renew Team Plan?">
    Team Plan can be renewed from the **Usage** page by clicking **Renew** before expiration.
  </Accordion>

  <Accordion title="Can enterprise customers use offline payment instead of frontend purchase?">
    Yes. Enterprise customers can contact the CodeBanana team for offline payment support.
  </Accordion>

  <Accordion title="Will existing users of the old Team Plan lose their benefits?">
    No. Existing Team Plan users are not affected by the transition. They can continue using their current Team Plan benefits until those benefits expire or are fully used.
  </Accordion>
</AccordionGroup>
