> For the complete documentation index, see [llms.txt](https://docs.rivalryze.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rivalryze.com/for-guild-admins/hosting-guild-contests.md).

# Hosting Guild Contests

A **Guild Contest** is a Contest only your Guild's members can join. It gets its own post in your server's Contests forum, where the bot keeps everyone up to date. This page is the Guild admin's view; for the general rules, see [Hosting Your Own Contest](/contests/hosting-a-contest.md).

## Who can create Guild Contests

* The Guild's **Owner** and **Admins** can always create them.
* Regular members can when **Any Guild Member** is on, under **Settings → Access Control → Contest creation**. It's on by default.

The host must be a member of the Guild on RivalRyze. See [Guild Settings & Activity Feed](/for-guild-admins/guild-settings.md#contest-creation).

## Creating a Guild Contest

Contests are created on the website:

* On your Guild page, click **Create Guild Contest**. The Contest creator opens with your Guild already picked.
* Or run `/create-challenge` in your server. The bot replies with a **Create a Battle** button that opens the creator with your server already picked. Add the `game` option to pick the game too.
* Or start from **Contests** on the website and pick your Guild in the settings step.

In the creator, choose the Contest type and Objective Mode, then in **Settings & Prizes** go to **Battle Settings** → **Who can join?** and pick **Guild Contest** (marked **Recommended**): *Only members of your Discord server can join. The battle gets its own thread in your server.* Then choose your Guild in **Guild \***.

The **Guild \*** list shows the Guilds you own and the Guilds that allow members to create Contests. If it's empty, you see *You have no eligible guilds to deploy contests to.*

The other **Who can join?** options (**Public**, **Invite Only**, **Password Protected**) are covered in [Access Policies](/contests/access-policies.md).

## Restricting a Contest to certain roles

With **Guild Contest** selected, turn on **Restrict to specific roles** and select one or more of your Discord roles. Only Guild members holding one of those roles can join: *Only guild members with one of the selected roles can join this battle.* With no role selected, every Guild member can join.

Ideas: a Contest for your subscribers' role, a "mods vs. members" event, or a bracket for a rank role.

## Discord role rewards

Guild Contests can award Discord roles on top of Gems. In **Settings & Prizes**, open the **Guild Rewards** tab (marked **New!**; it's only available for Guild Contests):

1. Turn **Guild Rewards** on.
2. Pick a role in **Guild Role**. You can add several.
3. For each role, choose who gets it: **Winner**, **Top 3** or **All Participants**.
4. Set the **Role Removal Period**: **Never**, **1 Week** or **1 Month**. With a period set, the role is taken back after that time.

Players who finish in the chosen range earn the role as a Contest reward. If it isn't given automatically, they can claim it from their **Rewards** page.

{% hint style="warning" %}
Only the Guild's Owner and Admins can add role rewards. The bot can only hand out a role when it has the **Manage Roles** permission and its own role is above both the reward role and the player's highest role. If no roles show up, see *Unable to load guild roles* in the [Bot Permissions Checklist](/for-guild-admins/bot-permissions.md#roles-and-role-hierarchy).
{% endhint %}

## Your Contests forum

When your Contests forum (`⚔️︱contests`) is synced, every Guild Contest gets its own forum post there. The bot:

* posts the Contest's details with buttons to **Join Battle**, **Request Access**, **Boost Battle**, **View Leaderboard** and **Update Stats**;
* pins the post and adds a reaction, if it has the permissions to;
* adds updates to the thread as the Contest runs: when it starts, when players join or are invited, when someone donates, match results for Dota 2, League of Legends and Teamfight Tactics Battles, and the result;
* announces the winner with **Tip** buttons so members can send them Gems, or says the Contest ended with no winner or was cancelled.

Members can read the forum but can't post in it; Contests are created on the website only.

If posts stop appearing, run `/guild-permissions`. It checks the forum and the Contest threads the bot tracks. See the [Bot Permissions Checklist](/for-guild-admins/bot-permissions.md).

## Global Contests in your server

RivalRyze runs featured global Contests open to every community. If **Participate in Global Contests** is on (**Settings → Access Control**), each one also gets a post in your Contests forum, so your members can join from your server. See [Guild Settings & Activity Feed](/for-guild-admins/guild-settings.md#global-contests).

## Guild Versus Guild

In a Guild Versus Guild Contest, Guilds compete against each other: each Guild's top players add up to a Guild total, and the winning Guild's counted players share the prize. When your Guild's Owner or an Admin joins one for your Guild, the bot opens a thread for it in your Contests forum, and your members' activity in the Contest is posted there. Discord role rewards aren't available on Guild Versus Guild Contests.

See [Guild Versus Guild](/contests/guild-vs-guild.md) for the full rules.

## Prizes and boosts

Guild Contests use the same entry fees, prize pools, boosts and donations as any other Contest. Anyone can add Gems to a running Contest's pool with **Boost Battle**. See [Entry Fees, Prize Pools & Donations](/contests/entry-fees-and-prizes.md).

## Results and disputes

Results come from the players' game data. Only a Contest's host gets its management tab; being a Guild Owner or Admin doesn't give you controls over Contests other members host.

If a member thinks a result is wrong (for example an achievement that didn't sync):

1. They should check their sync first. See [Troubleshooting Sync Issues](/connecting-gaming-platforms/troubleshooting-sync.md).
2. If it's still wrong, they should [contact support](/help-and-faq/contact-support.md) with the Contest's link.

Achievements that unlocked automatically across platforms are handled by [Fair Play](/fair-play/auto-pop-and-fair-play.md).

## Related

* [What is a Contest](/contests/what-is-a-contest.md)
* [Battles](/contests/battles.md)
* [Hosting Your Own Contest](/contests/hosting-a-contest.md)
* [Access Policies](/contests/access-policies.md)
* [Guild Settings & Activity Feed](/for-guild-admins/guild-settings.md)
* [Bot Commands Reference](/for-guild-admins/bot-commands-reference.md)