> ## Documentation Index
> Fetch the complete documentation index at: https://discord-platform-username.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sticker Resource

> Reference for Discord sticker objects and management endpoints.

export const Route = ({method, children}) => {
  return <div className="MDXRoute">
      <span className={"verb" + " " + method.toLowerCase()}>{method}</span>
      <span className="url">{children}</span>
    </div>;
};

export const ManualAnchor = ({id}) => {
  return <div className="MDXManualAnchor" id={id}></div>;
};

### Sticker Object

Represents a sticker that can be sent in messages.

<ManualAnchor id="sticker-object-sticker-structure" />

###### Sticker Structure

| Field        | Type                                                  | Description                                                                                 |
| ------------ | ----------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| id           | snowflake                                             | [id of the sticker](/developers/reference#image-formatting)                                 |
| pack\_id?    | snowflake                                             | for standard stickers, id of the pack the sticker is from                                   |
| name         | string                                                | name of the sticker                                                                         |
| description  | ?string                                               | description of the sticker                                                                  |
| tags\*       | string                                                | autocomplete/suggestion tags for the sticker (max 200 characters)                           |
| type         | integer                                               | [type of sticker](/developers/resources/sticker#sticker-object-sticker-types)               |
| format\_type | integer                                               | [type of sticker format](/developers/resources/sticker#sticker-object-sticker-format-types) |
| available?   | boolean                                               | whether this guild sticker can be used, may be false due to loss of Server Boosts           |
| guild\_id?   | snowflake                                             | id of the guild that owns this sticker                                                      |
| user?        | [user](/developers/resources/user#user-object) object | the user that uploaded the guild sticker                                                    |
| sort\_value? | integer                                               | the standard sticker's sort order within its pack                                           |

\* A comma separated list of keywords is the format used in this field by standard stickers, but this is just a convention.
Incidentally the client will always use a name generated from an emoji as the value of this field when creating or modifying a guild sticker.

<ManualAnchor id="sticker-object-sticker-types" />

###### Sticker Types

| Type     | Value | Description                                           |
| -------- | ----- | ----------------------------------------------------- |
| STANDARD | 1     | an official sticker in a pack                         |
| GUILD    | 2     | a sticker uploaded to a guild for the guild's members |

<ManualAnchor id="sticker-object-sticker-format-types" />

###### Sticker Format Types

| Type   | Value |
| ------ | ----- |
| PNG    | 1     |
| APNG   | 2     |
| LOTTIE | 3     |
| GIF    | 4     |

<ManualAnchor id="sticker-object-example-sticker" />

###### Example Sticker

```json theme={null}
{
  "id": "749054660769218631",
  "name": "Wave",
  "tags": "wumpus, hello, sup, hi, oi, heyo, heya, yo, greetings, greet, welcome, wave, :wave, :hello, :hi, :hey, hey, \ud83d\udc4b, \ud83d\udc4b\ud83c\udffb, \ud83d\udc4b\ud83c\udffc, \ud83d\udc4b\ud83c\udffd, \ud83d\udc4b\ud83c\udffe, \ud83d\udc4b\ud83c\udfff, goodbye, bye, see ya, later, laterz, cya",
  "type": 1,
  "format_type": 3,
  "description": "Wumpus waves hello",
  "pack_id": "847199849233514549",
  "sort_value": 12
}
```

### Sticker Item Object

The smallest amount of data required to render a sticker. A partial sticker object.

<ManualAnchor id="sticker-item-object-sticker-item-structure" />

###### Sticker Item Structure

| Field        | Type      | Description                                                                                 |
| ------------ | --------- | ------------------------------------------------------------------------------------------- |
| id           | snowflake | id of the sticker                                                                           |
| name         | string    | name of the sticker                                                                         |
| format\_type | integer   | [type of sticker format](/developers/resources/sticker#sticker-object-sticker-format-types) |

### Sticker Pack Object

Represents a pack of standard stickers.

<ManualAnchor id="sticker-pack-object-sticker-pack-structure" />

###### Sticker Pack Structure

| Field               | Type                                                                     | Description                                                                     |
| ------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| id                  | snowflake                                                                | id of the sticker pack                                                          |
| stickers            | array of [sticker](/developers/resources/sticker#sticker-object) objects | the stickers in the pack                                                        |
| name                | string                                                                   | name of the sticker pack                                                        |
| sku\_id             | snowflake                                                                | id of the pack's SKU                                                            |
| cover\_sticker\_id? | snowflake                                                                | id of a sticker in the pack which is shown as the pack's icon                   |
| description         | string                                                                   | description of the sticker pack                                                 |
| banner\_asset\_id?  | snowflake                                                                | id of the sticker pack's [banner image](/developers/reference#image-formatting) |

<ManualAnchor id="sticker-pack-object-example-sticker-pack" />

###### Example Sticker Pack

```json theme={null}
{
  "id": "847199849233514549",
  "stickers": [],
  "name": "Wumpus Beyond",
  "sku_id": "847199849233514547",
  "cover_sticker_id": "749053689419006003",
  "description": "Say hello to Wumpus!",
  "banner_asset_id": "761773777976819732"
}
```

## Get Sticker

<Route method="GET">/stickers/[\{sticker.id}](/developers/resources/sticker#sticker-object)</Route>

Returns a [sticker](/developers/resources/sticker#sticker-object) object for the given sticker ID.

## List Sticker Packs

<Route method="GET">/sticker-packs</Route>

Returns a list of available sticker packs.

<ManualAnchor id="list-sticker-packs-response-structure" />

###### Response Structure

| Field          | Type                                                                               |
| -------------- | ---------------------------------------------------------------------------------- |
| sticker\_packs | array of [sticker pack](/developers/resources/sticker#sticker-pack-object) objects |

## Get Sticker Pack

<Route method="GET">/sticker-packs/[\{pack.id}](/developers/resources/sticker#sticker-pack-object)</Route>

Returns a [sticker pack](/developers/resources/sticker#sticker-pack-object) object for the given sticker pack ID.

## List Guild Stickers

<Route method="GET">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/stickers</Route>

Returns an array of [sticker](/developers/resources/sticker#sticker-object) objects for the given guild. Includes `user` fields if the bot has the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.

## Get Guild Sticker

<Route method="GET">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/stickers/[\{sticker.id}](/developers/resources/sticker#sticker-object)</Route>

Returns a [sticker](/developers/resources/sticker#sticker-object) object for the given guild and sticker IDs. Includes the `user` field if the bot has the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission.

## Create Guild Sticker

<Route method="POST">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/stickers</Route>

Create a new sticker for the guild. Send a `multipart/form-data` body. Requires the `CREATE_GUILD_EXPRESSIONS` permission. Returns the new [sticker](/developers/resources/sticker#sticker-object) object on success. Fires a [Guild Stickers Update](/developers/events/gateway-events#guild-stickers-update) Gateway event.

Every guilds has five free sticker slots by default, and each Boost level will grant access to more slots.

<Info>
  This endpoint supports the `X-Audit-Log-Reason` header.
</Info>

<Warning>
  Lottie stickers can only be uploaded on guilds that have either the `VERIFIED` and/or the `PARTNERED` [guild feature](/developers/resources/guild#guild-object-guild-features).
</Warning>

<Warning>
  Uploaded stickers are constrained to 5 seconds in length for animated stickers, and 320 x 320 pixels.
</Warning>

<ManualAnchor id="create-guild-sticker-form-params" />

###### Form Params

| Field       | Type          | Description                                                                            |
| ----------- | ------------- | -------------------------------------------------------------------------------------- |
| name        | string        | name of the sticker (2-30 characters)                                                  |
| description | string        | description of the sticker (empty or 2-100 characters)                                 |
| tags        | string        | autocomplete/suggestion tags for the sticker (max 200 characters)                      |
| file        | file contents | the sticker file to upload, must be a PNG, APNG, GIF, or Lottie JSON file, max 512 KiB |

## Modify Guild Sticker

<Route method="PATCH">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/stickers/[\{sticker.id}](/developers/resources/sticker#sticker-object)</Route>

Modify the given sticker. For stickers created by the current user, requires either the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission. For other stickers, requires the `MANAGE_GUILD_EXPRESSIONS` permission. Returns the updated [sticker](/developers/resources/sticker#sticker-object) object on success. Fires a [Guild Stickers Update](/developers/events/gateway-events#guild-stickers-update) Gateway event.

<Note>
  All parameters to this endpoint are optional.
</Note>

<Info>
  This endpoint supports the `X-Audit-Log-Reason` header.
</Info>

<ManualAnchor id="modify-guild-sticker-json-params" />

###### JSON Params

| Field       | Type    | Description                                                       |
| ----------- | ------- | ----------------------------------------------------------------- |
| name        | string  | name of the sticker (2-30 characters)                             |
| description | ?string | description of the sticker (2-100 characters)                     |
| tags        | string  | autocomplete/suggestion tags for the sticker (max 200 characters) |

## Delete Guild Sticker

<Route method="DELETE">/guilds/[\{guild.id}](/developers/resources/guild#guild-object)/stickers/[\{sticker.id}](/developers/resources/sticker#sticker-object)</Route>

Delete the given sticker. For stickers created by the current user, requires either the `CREATE_GUILD_EXPRESSIONS` or `MANAGE_GUILD_EXPRESSIONS` permission. For other stickers, requires the `MANAGE_GUILD_EXPRESSIONS` permission. Returns `204 No Content` on success. Fires a [Guild Stickers Update](/developers/events/gateway-events#guild-stickers-update) Gateway event.

<Info>
  This endpoint supports the `X-Audit-Log-Reason` header.
</Info>