title: "Clickable Links and Customizable Statuses in Rich Presence"

date: "2025-07-17"

topics:

- "Activities"

- "Embedded App SDK"

We've added new functionality to Rich Presences to give users of your application a more interactive and flexible experience. There are two big changes as part of this:

- You can now add clickable links to the state text, details text, large image & small image

- You can now choose which field (name, state, or details) is used in users' status text in the member list (e.g. instead of "Listening to MyMusic" you can now have your status text show "Listening to Rick Astley")

All of these new fields are documented on the [Activity Object](/docs/events/gateway-events#activity-object) section of Gateway Events and also available through the Embedded App SDK.

| details_url? | string \| null |

| state_url? | string \| null |

| large_url? | string \| null |

| small_url? | string \| null |

| Field | Type | Description |

|----------------------|--------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|

| name | string | Activity's name |

| type | integer | [Activity type](/docs/events/gateway-events#activity-object-activity-types) |

| url? | ?string | Stream URL, is validated when type is 1 |

| created_at | integer | Unix timestamp (in milliseconds) of when the activity was added to the user's session |

| timestamps? | [timestamps](/docs/events/gateway-events#activity-object-activity-timestamps) object | Unix timestamps for start and/or end of the game |

| application_id? | snowflake | Application ID for the game |

| status_display_type? | ?integer | [Status display type](/docs/events/gateway-events#activity-object-status-display-types); controls which field is displayed in the user's status text in the member list |

| details? | ?string | What the player is currently doing |

| details_url? | ?string | URL that is linked when clicking on the details text |

| state? | ?string | User's current party status, or text used for a custom status |

| state_url? | ?string | URL that is linked when clicking on the state text |

| emoji? | ?[emoji](/docs/events/gateway-events#activity-object-activity-emoji) object | Emoji used for a custom status |

| party? | [party](/docs/events/gateway-events#activity-object-activity-party) object | Information for the current party of the player |

| assets? | [assets](/docs/events/gateway-events#activity-object-activity-assets) object | Images for the presence and their hover texts |

| secrets? | [secrets](/docs/events/gateway-events#activity-object-activity-secrets) object | Secrets for Rich Presence joining and spectating |

| instance? | boolean | Whether or not the activity is an instanced game session |

| flags? | integer | [Activity flags](/docs/events/gateway-events#activity-object-activity-flags) `OR`d together, describes what the payload includes |

| buttons? | array of [buttons](/docs/events/gateway-events#activity-object-activity-buttons) | Custom buttons shown in the Rich Presence (max 2) |

| ID | Name | Example |

|----|---------|----------------------------------------|

| 0 | Name | "Listening to Spotify" |

| 1 | State | "Listening to Rick Astley" |

| 2 | Details | "Listening to Never Gonna Give You Up" |

:::info

This applies to all activity types. "Listening" was used to serve as a consistent example of what the different fields might be used for.

:::

| large_url? | string | URL that is opened when clicking on the large image |

| small_url? | string | URL that is opened when clicking on the small image |

"state_url": "https://example.com/groups/50335231-9d9d-4ebd-873b-984787ee4d1d",

"details_url": "https://example.com/matches/42340203-2f25-4534-8ff6-2a6509e81207",

"large_url": "https://example.wiki/maps/Numbani",

"small_text": "Pharah",

"small_url": "https://example.wiki/characters/Pharah"