> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.rivalryze.com/for-guild-admins/guild-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.