> 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/guild-settings.md).

# Guild Settings & Activity Feed

After your guild is registered, configure how the RivalRyze Bot behaves in your server. Settings live in two places:

* **On the website** at **Guild → Manage** — for permanent configuration.
* **In Discord** via the `/guild-settings` command — for quick toggles without leaving chat.

## The Activity Feed

The Activity Feed is the channel where the bot posts public guild events automatically. Pick a channel that members are likely to see (e.g., `#rivalryze`, `#general`, `#battles`).

### What posts to the Activity Feed

By default, the bot posts:

* **Contest started** — when a guild member hosts a Contest.
* **Contest ended** — final result with the winner.
* **New member joined the guild on RivalRyze** — welcome the newcomer.
* **Big achievement unlocks** — when a member unlocks a rare achievement (off by default; opt-in).
* **Leaderboard milestones** — when a member breaks into the top 10 of any leaderboard.
* **Weekly summary** — every Monday, a recap of the week's activity.

Each post type can be enabled or disabled individually under **Guild → Manage → Activity Feed**.

### Changing the channel

* **In Discord:** run `/guild-settings` and select **Activity Channel** → pick a new channel.
* **On the website:** Guild → Manage → Activity Channel → pick from the dropdown.

{% hint style="success" %}
Create a dedicated `#rivalryze-feed` channel for these posts so they don't drown out conversation in `#general`. The bot will only post to one channel — you choose which.
{% endhint %}

## Other settings

### Guild description and banner

* **Description** — a short paragraph displayed on your guild's RivalRyze page. Members read this when discovering your guild.
* **Banner** — header image on the guild page. Upload from **Guild → Manage → Branding**.

### Default Contest visibility

When members host Contests in your server (via `/create-challenge`), the default access policy is **Guild Members Only**. You can change the default to:

* **Public** — guild Contests are visible to the whole RivalRyze community by default (great for promoting your guild).
* **Guild Members Only** — keep them in-house.
* **Allowlist** — every Contest requires host approval (very controlled communities).

Hosts can override the default on a per-Contest basis, but the default is what they start with.

### Member auto-link

When members join your Discord server, you can configure RivalRyze to automatically prompt them via DM to link their account. This is opt-in to avoid being spammy.

* **Off (default):** new members get no DM.
* **On:** new members receive a friendly DM from the bot explaining RivalRyze and inviting them to sign up.

### Notifications quiet hours

If your server has a global "quiet" period (e.g., overnight), you can configure the Activity Feed to only post during specific hours.

* **All times** (default)
* **Custom window** — set a daily start and end time in your guild's timezone.

### Timezone

Set your guild's timezone for accurate "weekly summary" timing and leaderboard reset boundaries.

## Quick reference: `/guild-settings`

Run `/guild-settings` in any channel to bring up an interactive menu. From there, you can:

| Action                      | Description                                                         |
| --------------------------- | ------------------------------------------------------------------- |
| **View current settings**   | Shows all current configuration at a glance.                        |
| **Sync with Discord**       | Re-pull the guild name, icon, and member roles from Discord.        |
| **Change activity channel** | Pick a different channel for the Activity Feed.                     |
| **Toggle post types**       | Enable / disable specific Activity Feed post types.                 |
| **Verify permissions**      | Same as `/guild-permissions` — checks the bot can do what it needs. |

{% hint style="info" %}
Only users with the **Manage Server** permission can change guild settings (whether via web or the `/guild-settings` command). Other members can view settings but not change them.
{% endhint %}

## Permission-related settings

The bot can be configured to assign Discord roles based on player rank or achievements. This is **off by default** — you need to explicitly enable it and tell the bot which roles to manage.

* **Tier-based roles** — assign roles like "Bronze," "Silver," "Gold," "Platinum" based on guild leaderboard standing.
* **Achievement roles** — assign a role when a member hits a specific milestone (first Contest win, 100 achievements unlocked, etc.).

Configure under **Guild → Manage → Role Automation**.

The bot will only manage roles you explicitly grant it permission to manage. It cannot create roles or modify roles outside its scope.

## Saving and previewing

All settings save immediately when you click **Save**. There's no "draft" mode.

For Activity Feed post types, you can use **Send Test Post** to preview what a particular post will look like in your channel before enabling it permanently.

## Resetting to defaults

If you want to start over, **Guild → Manage → Reset Settings** restores all settings to their defaults. This doesn't affect your guild's data — only its configuration.