> ## Documentation Index
> Fetch the complete documentation index at: https://discord-markm-docs-lobby-membership-disconnect.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 as described in [Uploading Files](/developers/reference#uploading-files). 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>