# Discord Rich Presence

{% hint style="danger" %}
**ATTENTION**: This feature is currently no longer within Sonoran CMS and will be reintroduced in a future update.
{% endhint %}

{% hint style="info" %}
Rich presence is included with all versions of Sonoran CMS, but customization requires the **Standard** plan or higher, and the **Pro** plan for complete customization with the icon.\
For more information, see our [pricing](/cms/pricing/pricing-faq.md) or view how to check your community [limits](/cms/tutorials/administrative/view-your-limits.md).
{% endhint %}

## What is Discord Rich Presence?

When running our [desktop application](/cms/download.md), Discord can automatically detect and display information about your community.

![Sonoran CMS - Discord Rich Presence](/files/-MfkgSQj2zQvTuISZplB)

## Customizing your Rich Presence

![Sonoran CMS - Discord Rich Presence Customization](/files/-Mfkgq8Q7be41P_3dpp1)

### Customizing Buttons

Discord presence currently allows for two customizable buttons.

Navigate to Administrator Panel > Customization > Community Customization > Discord Rich Presence Customization

#### For communities on the **Standard** plan or higher:

\- Button #2 may be customized to any [Sonoran CAD](https://github.com/Sonoran-Software/SonoranCMS-Documentation/blob/master/integration-capabilities/broken-reference/README.md) or [Sonoran CMS](https://info.sonorancms.com/why-choose-sonoran-cms/why-choose-sonoran-cms) invitation link.\
\- Ex: `https://sonorancad.com/#/?comid=mycommunityid` or `https://sonorancms.com/#/?comid=mycommunityid`

#### For communities on the Pro plan:

\- Both buttons may be customized to any URL desired.\
\- The Icon and title can also be customized with a Discord developer application.

### Customizing the Icon

Communities on the **Pro** version may customize the rich presence icon:

#### 1. Create a new Discord Application

On <https://discord.com/developers/applications> create a new application

![Discord Developer - New Application](/files/-MfkhHTFNNHQHi43JAMs)

#### 2. Copy your Client ID

Under OAuth2, copy your `Client ID`

![Discord Developer - Application Client ID](/files/-MfkhKXwtVR0Nl-kBght)

#### 3. Add an Icon

Next, upload an icon for your new application. Be sure to copy down the name of the icon for later.

![Discord Developer - Application Icon](/files/-MfkhNEsDzYpOpMAMJqL)

#### 4. Configure in Sonoran CMS

Back in the admin customization menu, we can paste the Discord application's Client ID and Icon name.

![Sonoran CMS - Custom Discord Presence Config](/files/-MfkhvXhFsNyIdwcbONc)

Once saved, your Discord presence for all community members will reflect your custom icon, title, and buttons.

![Sonoran CAD - Custom Discord Presence View](/files/-MfkiDFMxKDxutPALa7Q)

## Toggle On/Off Rich Presence <a href="#toggle-on-off-rich-presence" id="toggle-on-off-rich-presence"></a>

### Community Toggle <a href="#community-toggle" id="community-toggle"></a>

To hide the invite button for your community's Discord Rich Presence, simply leave the button text and URL blank.

### User Toggle <a href="#user-toggle" id="user-toggle"></a>

In the profile dropdown, users can toggle this display on or off for their individual desktop client.

![Sonoran CMS Profile Dropdown - Disable Discord's Rich Presence](/files/-MfkiXWt9WQmMPhq7sLr)


---

# Agent Instructions: 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:

```
GET https://docs.sonoransoftware.com/cms/integration-capabilities/discord-rich-presence.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
