Donation Display Guide

What is Donation Ranking & Goal?#

Donation Ranking displays a real-time leaderboard of donors on your OBS widget, while Donation Goal shows total donation counts in various visual styles. Multi-platform donations can be unified using configurable exchange rates.

How to Use Donation Ranking#

• Open the Donation Ranking page from the widget sidebar.
• Click Create New to create a ranking configuration.
• Customize fonts, colors, display count, and more.
• Copy the OBS URL and add it as a browser source.

How to Use Donation Goal#

• Open the Donation Goal page from the widget sidebar.
• Choose a visual type (progress bar, heartwave, battery, etc.).
• Set the goal start and goal max values.
• Copy the OBS URL and add it as a browser source.

How to Set Up in OBS#

• In OBS Studio, select Add Source → Browser.
• Paste the copied OBS URL.
• Ranking: recommended size 400×600, Goal: recommended size 500×150
• Use Custom CSS for additional customization.

About Exchange Rates#

• SOOP — Star Balloons
• YouTube — Super Chat (KRW)
• Twitch — Bits
• Chzzk — Cheese
• Kick — Sub/Gift
• TikTok — Coins
• Douyu — Fish Balls
• Bilibili — Gold
• Huya — Blue Diamonds
• Douyin — Diamonds
• Kuaishou — Coins
• Rumble — Rant ($)

Exchange rates convert 1 unit of each platform’s donation to KRW. They are applied automatically; in Donation Goal you can pick a ‘reference platform’ to unify the display unit.

Fun Ways to Use Donation Displays#

• Donation race: Show the leaderboard on screen and announce ‘Special event for today’s top donor!’ to spark competitive giving
• Goal event: Set a goal like ‘At 100 donations, I do a challenge!’ and show real-time progress with the Donation Goal widget
• Cross-platform unified ranking: Convert YouTube Super Chat + CHZZK Cheese + SOOP Star Balloons to a fair unified leaderboard

When changes are not reflected in the URL#

Double-click the source with the URL in OBS, check the ‘Refresh browser when scene becomes active’ checkbox, and click the ‘Refresh cache of current page’ button.