# Rich Presence Setup

This guide provides an explanation for each user interface element in your application, allowing you to effectively set up and manage Discord Rich Presence.

***

### Custom RP Components

* **Client ID Field**: Enter the unique identifier for your Discord application. This is essential to establish a link between your application and Discord.&#x20;
* **Connect/Disconnect Rich Presence Button**: This button allows you to disconnect the current Rich Presence, effectively ending the session and clearing the user's status.&#x20;
* **Details Field**: Describes the main activity, such as "Playing Minecraft". This is what will appear as the primary status message on a user's Discord profile.
* **State Field**: Provides additional details about the user's current activity, like "In a Dungeon", giving more context to the status displayed.
* [**Large Image Key**](#setting-up-image-keys-via-discord-developer-portal): The key for the large image that will be displayed in the Rich Presence. This image represents the main visual element.
* **Large Image Text**: Text that appears when someone hovers over the large image, providing context or details about the image displayed.
* [**Small Image Key**](#setting-up-image-keys-via-discord-developer-portal): The key for a smaller image that appears alongside the large image, serving as a secondary visual cue in the Discord status.
* **Small Image Text**: Hover text for the small image, offering further information or fun facts when the cursor is placed over it.
* **Button Labels and URLs**: You can add up to two buttons with customizable labels and links. These buttons can direct users to external sites, such as your homepage or a promotional link, enhancing interaction.
* **Save Presence Button**: Saves the current settings and updates the Rich Presence on Discord, allowing the changes to be reflected immediately on the user's profile.

***

### Configuration Steps

1. **Input Client ID**: Start by entering your Discord application's Client ID to initiate the configuration.
2. **Customize Details and State**: Specify what you are doing and any additional context.
3. **Set Image Keys and Texts**: Assign keys for the large and small images and define their hover texts.
4. **Add Interactive Buttons**: Optionally, include up to two interactive buttons with relevant labels and URLs.
5. **Apply Changes**: Click "Save Presence" to update your Discord profile with the new Rich Presence settings.
6. **Manage Connections**: Use "Disconnect Rich Presence" to end the Rich Presence if necessary.

#### Setting Up Image Keys via Discord Developer Portal

1. **Navigate to the Discord Developer Portal**: Log in and select your application.
2. **Go to the Rich Presence Tab**: Click on 'Art Assets'.
3. **Upload Images**: Upload your images for the large and small image slots.
4. **Assign Keys**: After uploading, each image will be assigned a unique key. Use these keys in your application to refer to the images.

***

By following these instructions, you can effectively utilize Discord Rich Presence to display your current activities directly on your Discord status. This setup allows for a more personal touch in your online presence, making your gaming or application experiences more visible to friends and communities on Discord.


---

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

```
GET https://av0.gitbook.io/av/applications/status-rotator++/rich-presence-setup.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.
