> For the complete documentation index, see [llms.txt](https://rplaylive.gitbook.io/creatorguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rplaylive.gitbook.io/creatorguide/en/how-to/donation-goals.md).

# Donation Goals

Set a donation goal and show its progress on your stream screen.

Donation Goals let you set a target amount and time period, then show how much of the goal has been reached on the stream screen. RPLAY automatically totals donation coins received during the selected period and displays the progress through an OBS widget.

Use a goal to introduce content or an event you will run when the target is reached, and invite viewers to work toward it with you.

#### Ways to Use Donation Goals

* Run a special stream when the goal is reached.
* Set a shared goal with viewers for an anniversary stream.
* Raise support for new content or streaming equipment.
* Track a cumulative donation goal across a multi-day event.

#### Set Up a Donation Goal

At the top of Live Studio, click **Donation**, then open the **Donation Goals** tab.

1. Click **New Goal**.
2. Under **Basic Settings**, enter the following:

| Category           | Detail                                                                                                                      |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Goal Title**     | The goal name shown on the stream screen. Maximum 100 characters.                                                           |
| **Initial Amount** | An amount added to the donations received during the goal period. Enter **0** if there is no amount to add.                 |
| **Target Amount**  | The number of donation coins you want to reach. Set it to at least 1 coin.                                                  |
| **Goal Period**    | The start and end date and time used to total donations. Set both the date and time, and make the end later than the start. |

Enter the Initial Amount and Target Amount as whole numbers in coins. The Initial Amount can be 0 or higher.

3. Check the displayed information under **Preview**.
4. Click **Save Goal** at the bottom.

<figure><img src="https://887091347-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWZ2iWAPtBWVHYoDD4Mt6%2Fuploads%2FyL2rlvcAujuRsWcxOgfY%2FScreenshot%202026-09-14%20at%205.14.18%E2%80%AFPM.png?alt=media&amp;token=101ed6ca-4bdd-43aa-8bc7-b5f9a8a8a8ca" alt=""><figcaption></figcaption></figure>

#### Customize a Donation Goal

Use **Style Settings** to match the widget to your stream screen.

* **Widget Layout:** Choose Stacked, Inline, or Card.
* **Show Goal Percentage:** Choose whether to display the completion rate as a percentage.
* **Progress Bar Customization:** Change the bar color, background color, and height.
* **Show Text Outline:** Set its visibility, color, and thickness.
* **Title and Body Text:** Change the font size and text color for each.

Adjust the settings while checking **Preview (top of screen)**, then click **Save Goal**.

<figure><img src="https://887091347-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWZ2iWAPtBWVHYoDD4Mt6%2Fuploads%2F4DfUFM1pwf3kk2zp0wS5%2FScreenshot%202026-09-14%20at%205.15.36%E2%80%AFPM.png?alt=media&amp;token=68066ba5-70c6-4f01-9c8c-756b384a6c68" alt=""><figcaption></figcaption></figure>

#### Display the Goal on the Stream Screen

Add the saved goal’s widget URL to OBS to display the goal and its progress.

1. Select the goal you want to display, then click **Save Goal**.
2. Under **Widget URL**, click **Generate** and copy the URL. If a URL is already displayed, copy that URL.
3. In the OBS Sources list, select **+ > Browser**, then enter the copied URL.
4. Adjust the widget’s position and size on the stream screen.

The widget shows the Goal Title, Current Amount, Goal Amount, and end date. If **Show Goal Progress** is on, it also shows the completion percentage.

#### How Donation Amounts Are Counted

The Current Amount is calculated as **Initial Amount + donation coins received during the selected period**.

For example, if the Initial Amount is 1,000 coins, the Goal Amount is 10,000 coins, and you receive 4,000 coins during the period, the Current Amount is 5,000 coins and the progress is 50%.

* Coins received from Chat Donation, Roulette Donation, and processed Mission Donation results are included.
* Mission Donations are included when the result is processed and the coins are paid. For failed or canceled missions, any failure compensation or cancellation fee paid to the creator is included.
* The total covers all donations received during the selected period, not only the current stream session. If the start time is in the past, qualifying donations received before the goal was created are included.
* Donations continue to be added until the end time even after the Goal Amount is reached, so progress can exceed 100%.
* Donations received after the end time are not added. The widget remains visible, so hide the source in OBS when you no longer want it on the stream screen.

#### Edit a Goal or Create a New Goal

To edit an existing goal, choose it under **Donation Goal Settings**, make the changes, then click **Save Goal**. If you change the goal period, the donation amount is recalculated using the new period.

To add another goal, click **New Goal** and complete the settings. Existing goals remain in the list and can be selected again later.

To display a different goal on the stream screen, change the OBS Browser source URL to that goal’s Widget URL. Selecting another goal on the settings screen alone does not change the goal shown in OBS.

**Reset** restores unsaved changes to the most recently saved settings. It does not reset the accumulated donation amount to 0.