# Purchasing and managing World Credits

{% embed url="<https://youtu.be/kI_2kZsSSIU?feature=shared>" %}

## Overview

When users log in through your dedicated Breakroom [desktop app](https://docs.breakroom.tech/opening-the-doors/desktop-viewers), there are no additional access fees above the cost of their [seat](https://docs.breakroom.tech/opening-the-doors/seats-and-concurrency). World Stream access, on the other hand, must be purchased on a per user/per time basis using a digital currency known as *World Credits.*

[World Owners](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#owner) and [World Administrators](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#administrator) can purchase, track, and manage World Credits using the Dashboard. Unused World Credits never expire, even if your Breakroom subscription lapses.

{% hint style="info" %}
Only [World Owners](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#owner) and [World Administrators](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#administrator) can access the Dashboard.
{% endhint %}

## Purchasing World Credits

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2Fjf53paNrS1HYVlmIJwpo%2FWorld_Credits_001.png?alt=media&#x26;token=65dce698-f1f6-4dbc-a69e-ca996440c3cc" alt="" width="563"><figcaption><p>Pictured: The Add Credits panel.</p></figcaption></figure>

To purchase World Credits, follow these steps.

1. Navigate to your [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).
2. Click the **Add Credits button** located in the site header.
3. In the pop-up that appears, enter the number of World Credits you would like to purchase. Please note that World Credits must be purchased in increments of 1000 Credits.
4. Click the **Next button**, and complete your payment information.
5. When you are satisfied, click the **Confirm button** to finalize your purchase.

## Tracking your World Credits

### World Credit Balance widget

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FFXTYmgRlwVFzcIbtqJVX%2FWorld_Credits_002.png?alt=media&#x26;token=e520294c-3f6c-4c73-8fcd-6ede3389f5a5" alt="" width="563"><figcaption></figcaption></figure>

The World Credit Balance widget on the [Dashboard landing page](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour) allows you to quickly check your World Credit balance and most recent account activity. If you need[ additional World Credits](#purchasing-world-credits) fast, the **Add Credits link** is also available.

### World Credits tab

Alternatively, you can access a detailed breakdown of your World Credit purchases, refunds, and analytics by clicking the **World Credits tab** on your Dashboard.

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FTsTOv4k1fGi1JaduL9ZL%2FWorld_Credits_003.png?alt=media&#x26;token=275028f6-2377-4e6d-9210-1c70a0ccd06f" alt="" width="563"><figcaption><p>Pictured: An example of how the World Credits tab may appear.</p></figcaption></figure>

In addition to information about your World Credit transactions, the World Credits tab contains a number of important tools. Here's a brief guide to key parts of the UI.

<table><thead><tr><th width="287">Button or link</th><th>Function</th></tr></thead><tbody><tr><td>World Credit Balance panel</td><td>Displays your current World Credit balance, as well as your current-month purchases and expenditures.</td></tr><tr><td>Add Credits link / button</td><td>Allows you to purchase additional World Credits.</td></tr><tr><td>World Credit Analytics panel</td><td>Generates a quick World Credit purchase, expenditure, and availability breakdown based on your selected timeframe.</td></tr><tr><td>Transaction History panel</td><td>Provides a detailed, itemized list of your World Credit transactions and usage.</td></tr><tr><td>Transaction History search field</td><td>Allows you to search for a particular transaction.</td></tr><tr><td>Transaction History date pickers</td><td>Allows you to narrow the transaction history down to a specific date range.</td></tr><tr><td>Download CSV</td><td>Downloads a CSV file containing all transactions for the date period selected.</td></tr></tbody></table>

### Generating World Credit transaction and usage reports

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2Ff22ZRFvA2JlccMWi7BPS%2FWorld_Credits_004.png?alt=media&#x26;token=d69b6dae-ab17-44e4-b6d6-78b66ffba79a" alt="" width="563"><figcaption><p>Pictured: An example combined World Credit transaction history and usage report.</p></figcaption></figure>

**Transaction reports**

You can download your World Credit transaction history at any time by following these steps.

1. Navigate to your [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).
2. Click on the **World Credits tab**.
3. Scroll down to the **Transaction History panel**.
4. Use the **search field** or the **date pickers** to filter the transactions list, if necessary.
5. Click the **Download CSV link** located above the **date pickers** to download a spreadsheet containing your selected transaction data.

**Usage reports**

World Stream access and activity can also be tracked using the Transaction History panel on the World Credits tab.

1. Navigate to your [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).
2. Click on the **World Credits tab**.
3. Scroll down to the **Transaction History panel**.
4. Enter the term "usage" into the **search field**, and press the **Enter key** on your keyboard. Usernames are identified in the **Items column**.
5. Click the **Download CSV link** located above the **date pickers** to download a spreadsheet containing your selected transaction data.

{% hint style="info" %}
If you're looking for more detailed information concerning user session times and Region access, we suggest generating an [analytics report](https://docs.breakroom.tech/opening-the-doors/analytics).
{% endhint %}

## Managing World Credit usage

### Partial hours and World Credit consumption

Due to the way AWS structures its billing, World Stream usage is currently calculated in hourly increments (i.e., multiples of 60 minutes). This hourly calculation policy also extends to [pre-allocation campaigns](https://docs.breakroom.tech/opening-the-doors/world-stream/pre-allocation-campaigns) and [user session time limits](#setting-usage-limits).

This means that users cannot consume partial hours while logged in to World Stream. For example, if a user logs in for 20 minutes, the cost of one hour of access (60 minutes) will be deducted from the World Credits available on the account.&#x20;

For this reason, Breakroom gives [World Owners](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#owner) and [World Administrators](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#administrator) tools to limit World Stream user session times and World Credit consumption. World Owners can also place a cap on the number of World Credits that can be purchased each month by the administrative team.

### Setting World Stream usage limits

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FzSopx3k985T2nXK2yaLk%2FWorld_Credits_008.png?alt=media&#x26;token=9b8aaef4-cc25-4676-a7e3-333d06b6682d" alt=""><figcaption><p>Pictured: The Manage World Stream Usage panel.</p></figcaption></figure>

To help you get the most out of your World Credits, there are three types of usage limits you can impose:

1. **Maximum session time per user**, which sets a cap on how much time an individual user can spend in a *single* World Stream session.
2. **Monthly usage quota per user**, which sets a cap on how much time an individual user can spend in World Stream per month.
3. **Monthly usage quota for World**, which limits how many minutes *all* of your users can collectively spend in World Stream each month.

To enable any of these usage limits, follow the steps below.

1. Navigate to your [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).
2. Click on the **World Stream tab**.
3. Scroll down to the **Manage World Stream Usage panel**.
4. Locate the usage cap you want to enable. Click the **Edit button** located to the right of the usage cap name.
5. Enter your preferred **number of minutes** or click the **Unlimited button**.
6. Click the **Save button** when you are finished.

{% hint style="warning" %}
Important notes about monthly usage quotas:

* The **Monthly usage quota per World** cap does not discriminate between individual users. This means that a single user could potentially consume the entirety of your monthly usage quota.
* The World Credit [partial hours](https://docs.breakroom.tech/opening-the-doors/world-stream/..#partial-hours-and-world-credit-consumption) calculation policy also applies to monthly usage quotas. Users who log in for less than 60 minutes will still consume one 60-minute block of time from your monthly usage quota.
  {% endhint %}

### Choosing your World Stream server type

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FipLOZafSn8Iu5NNYN4MT%2FWorld_Credits_006.png?alt=media&#x26;token=40753c89-7203-4bb4-b661-5139d1fb3de2" alt="" width="563"><figcaption></figcaption></figure>

Another way that [World Owners](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#owner) and [World Administrators](https://docs.breakroom.tech/creating-and-managing-user-accounts/world-level-user-permissions#administrator) can manage costs is to select an appropriate World Stream server type. An updated list of server type features, prices, and regional availability can be found on the Dashboard, but in general, our Lite Servers offer acceptable performance for smaller events at a reduced cost.

To change your World Stream server type for all users, follow these steps.

1. Navigate to your [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).
2. Click on the **World Stream tab**.
3. Scroll to the **Your World Stream server type panel**.

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FAgMADHiqqfxoc4fqVywV%2FWorld_Credits_007.png?alt=media&#x26;token=87d7a8ed-7b24-4029-9b73-3cd35161a0c1" alt=""><figcaption><p>Highlighted: The "Change my World Stream server type" link.</p></figcaption></figure>

4. On the left side of the panel, you will see your current World Stream server type listed. To change it, click the **"Change my World Stream server type" link** located on the right side.
5. A pop-up will appear. Click on the server type you prefer.

### Setting World Credit purchase limits

<figure><img src="https://1679086873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gOE0ivmDtuXfHroTVSx%2Fuploads%2FkBv0mQAvZjU1XapqthSb%2FWorld_Credits_005.png?alt=media&#x26;token=f8303fea-ec57-4a3c-8637-603829f3265f" alt="" width="417"><figcaption><p>Highlighted: The Monthly Purchase Limit section of the World Credits tab.</p></figcaption></figure>

To limit the amount of World Credits that can be purchased on your Breakroom account each month, follow these steps.

1. Navigate to your [Dashboard](https://docs.breakroom.tech/building-new-worlds/breakroom-dashboard-tour).
2. Click on the **World Credits tab**.
3. Scroll to the **My Balance panel**. You will see your current **Monthly Purchase Limit** listed there.
4. To change the monthly limit, click the **Pencil icon** located to the right. A pop-up will appear. Enter the new purchase limit in the field, and click the **Save button**.