Store

Discord store resources have a long and convoluted history.

The store was originally built to support game developers selling games and in-game items on Discord, as well as GameSDK features. While this was deprecated soon after, the store infrastructure remained in place, fully functional. It was then used internally to power the Discord Nitro subscription service, as well as other ventures such as the now-defunct paid sticker packs.

Now, it has been repurposed to support guild and application monetization features, such as guild products and application subscriptions. As Discord has returned to gaming with the release of the Social SDK, it is now again being used to support sales of in-game items.

While the store infrastructure is still in use, most of the new features being built with it offer newer APIs to manage and interact with them. Certain new features may require using these new APIs to function properly, and may not be fully compatible with the older store APIs, even though they are using SKUs and store listings under the hood.

SKU Object

A purchasable item or group of items in Discord.

SKU Structure

SKU objects can either be localized or unlocalized. Localized SKUs only serialize strings and pricing for the user's location, while unlocalized SKUs serialize all strings and pricing for all locales. All objects serialized in the SKU inherit this behavior.

¹ Only included for localized SKUs.

² Only included for unlocalized SKUs.

³ Values have only been tracked since 2025-08-05T20:53:39.133830+00:00. Earlier SKUs will have this field set to this timestamp. See the snowflake format documentation for a more accurate creation timestamp.

SKU Type

SKU Product Line

SKU Flags

SKU Access Type

SKU Feature

SKU Genre

Content Rating Structure

Content Rating Agency

ESRB Content Rating

PEGI Content Rating

ESRB Content Descriptor

PEGI Content Descriptor

System Requirements Structure

System Requirement Structure

Operating System

SKU Price Structure

Premium Price Structure

External SKU Strategy Structure

External SKU Strategy Type

Tenant Metadata Structure

Guild Monetization Metadata Structure

Guild Powerup Metadata Structure

¹ Only included on store listing objects.

Game Server Powerup Metadata Structure

Guild Powerup Category Type

Example Game Server Powerup Metadata Structure

{
  "boost_price": 5,
  "purchase_limit": 1,
  "guild_features": {
    "features": ["GAME_SERVERS"],
    "additional_emoji_slots": 0,
    "additional_sticker_slots": 0,
    "additional_sound_slots": 0
  },
  "category_type": "game_server",
  "available_providers": ["SHOCKBYTE"],
  "memory": 8192,
  "cpu": 2,
  "storage": 100,
  "max_slots": 40,
  "memory_string": "8GB",
  "player_string": "40+"
}

Social Layer Metadata Structure

Example SKU

{
  "id": "1333912750274904064",
  "type": 3,
  "product_line": 11,
  "dependent_sku_id": null,
  "application_id": "521842831262875670",
  "manifest_labels": null,
  "access_type": 1,
  "name": "3-Day Nitro Credit",
  "features": [],
  "release_date": null,
  "premium": false,
  "slug": "3-day-nitro-credit",
  "flags": 4,
  "show_age_gate": false,
  "price": {
    "amount": 1400,
    "currency": "discord_orb",
    "currency_exponent": 0,
    "premium": {
      "2": {
        "amount": 1400,
        "percentage": 0
      }
    }
  },
  "tenant_metadata": {},
  "created_at": "2025-08-05T20:53:39.133830+00:00",
  "updated_at": "2025-08-05T20:53:39.135755+00:00"
}

Store Listing Object

A listing for a marketable item on Discord. Tied to a single SKU.

Store Listing Structure

Store listing objects can either be localized or unlocalized. Localized listings only serialize strings and pricing for the user's location, while unlocalized listings serialize all strings and pricing for all locales. All objects serialized in the listing inherit this behavior.

¹ Not included in contexts that are impossible for an unpublished listing to be in.

² Only includes the category_type, static_image_url, animated_image_url, and store_removal_date fields.

Store Listing Benefit Structure

Store Listing Icon Structure

¹ Only included if type is STORE_ASSET.

² Only included if type is EMOJI.

Store Listing Icon Type

Store Carousel Item Structure

¹ One of youtube_video_id or asset_id must be provided.

Store Note Structure

Example Store Listing

{
  "id": "983874530717990912",
  "summary": { "default": "Support Discord and get sweet chat perks." },
  "sku": {
    "id": "978380684370378762",
    "type": 5,
    "product_line": 1,
    "dependent_sku_id": null,
    "application_id": "521842831262875670",
    "manifest_labels": null,
    "access_type": 1,
    "name": { "default": "Nitro Basic" },
    "features": [],
    "release_date": null,
    "premium": false,
    "slug": "nitro-basic",
    "flags": 68,
    "tenant_metadata": {},
    "created_at": "2025-08-05T20:53:39.133830+00:00",
    "updated_at": "2025-08-05T20:53:39.135755+00:00"
  },
  "description": { "default": "Support Discord and get sweet chat perks." },
  "published": true,
  "thumbnail": { "id": "1039257000355307530", "size": 333286, "mime_type": "image/png", "width": 834, "height": 471 },
  "benefits": []
}

Subscription Plan Object

A recurring payment to maintain entitlement to an SKU.

Subscription Plan Structure

¹ Only included when fetched from the Get Published Subscription Plans or Get Bulk Published Subscription Plans endpoints.

¹ Only included when fetched from the Get Subscription Plans endpoint.

Partial Subscription Plan Structure

Subscription Prices Structure

Country Prices Structure

Subscription Interval

Subscription Plan Purchase Type

Example Subscription Plan

{
  "id": "944265636643602432",
  "name": "None 6 Month",
  "interval": 1,
  "interval_count": 6,
  "tax_inclusive": true,
  "sku_id": "628379670982688768",
  "currency": "usd",
  "price": 0,
  "price_tier": null,
  "prices": {
    "0": {
      "country_prices": {
        "country_code": "CA",
        "prices": [{ "currency": "usd", "amount": 0, "exponent": 2 }]
      },
      "payment_source_prices": {}
    }
  }
}

Store Asset Object

An image or video associated with a store resource.

Store Asset Structure

¹ Only included when fetched from the Get Application Store Assets or Create Application Store Asset endpoints.

Example Store Asset

{
  "id": "1059634086995574874",
  "size": 4161529,
  "mime_type": "image/gif",
  "filename": "kitties.gif",
  "width": 464,
  "height": 512
}

EULA Object

An End User License Agreement represents a legal agreement between the application owner and the end user.

EULA Structure

Storefront Object

A collection of store listings in a unified showcase.

Storefront Structure

Storefront Page Structure

Storefront Leaderboard Structure

Storefront Page Section Structure

Storefront Collection Object

A collection of storefront products.

Storefront Collection Structure

Storefront Product Object

An abstraction around SKUs for modern marketplace items on Discord.

Storefront Product Structure

Product Option Structure

Product Tenant Metadata Structure

Guild Monetization Product Metadata Structure

Game Server Powerup Product Metadata Structure

Game Server Instructions Structure

Product SKU Structure

Product SKU Option Structure

Product SKU Tenant Metadata Structure

Product SKU Plan Feature Structure

Example Product

{
  "id": "1458532555463589978",
  "application_id": "1340102344645283891",
  "sku_ids": ["1458532555463589979", "1460419709630677042", "1460419709630677043"],
  "name": "Hytale",
  "options": [
    {
      "name": "Memory",
      "option_values": ["5", "8", "12"]
    }
  ],
  "created_at": "2026-01-07T18:47:39.455084+00:00",
  "updated_at": "2026-02-27T18:40:56.037576+00:00",
  "tenant_metadata": {
    "guild_monetization": {
      "game_server": {
        "instructions": {
          "pc": [
            "Open Hytale.",
            "Click on **Servers**.",
            "Click on **Add Server**.",
            "Paste your server IP address, enter a server name and click **Add Server**.",
            "Double click your server in the list to join."
          ]
        },
        "deactivation_cooldown_period_days": 7,
        "game_application_id": "1458530944955973852",
        "provider": "shockbyte",
        "disabled": false,
        "early_access": true,
        "can_market": true
      }
    }
  },
  "skus": [
    {
      "id": "1458532555463589979",
      "type": 2,
      "product_line": 13,
      "application_id": "1340102344645283891",
      "name": "Starter Plan",
      "thumbnail_asset_id": null,
      "slug": "starter-plan",
      "premium": false,
      "selected_options": [
        {
          "option_name": "Memory",
          "option_value": "5"
        }
      ],
      "product_id": "1458532555463589978",
      "position": 0,
      "tenant_metadata": {
        "boost_price": 5,
        "purchase_limit": 1,
        "category_type": "game_server",
        "plan_features": [
          {
            "title": "4+",
            "description": "Players"
          },
          {
            "title": "5GB",
            "description": "RAM"
          },
          {
            "title": "3",
            "description": "vCPUs"
          }
        ]
      }
    }
  ]
}

Endpoints

Returns a list of SKU objects for the given application. User must be the owner of the application or member of the owning team.

Query String Params

Creates a new SKU. Returns the created SKU object on success. Requires an application with access to the store or monetization. User must be the owner of the application or member of the owning team.

JSON Params

Returns a SKU object for the given SKU ID. User must own the SKU's application or be a member of the owning team.

Query String Params

Modifies an existing SKU. Returns the modified SKU object on success. User must own the SKU's application or be a developer of the owning team.

JSON Params

Returns a list of store listing objects for the given SKU ID. User must own the SKU's application or be a member of the owning team.

Query String Params

Creates a new store listing. Returns the created store listing object on success. User must own the SKU's application or be a member of the owning team.

JSON Params

¹ Only youtube_video_id or asset_id can be set.

Returns a store listing object for the given listing ID. User must own the listing's application or be a member of the owning team.

Query String Params

Modifies an existing store listing. Returns the modified store listing object on success. User must own the listing's application or be a developer of the owning team.

JSON Params

¹ Only youtube_video_id or asset_id can be set.

Deletes an existing store listing. Returns a 204 empty response on success. User must own the listing's application or be a member of the owning team.

Returns a list of published store listing objects for the given application ID.

Query String Params

Returns a store listing object for the primary SKU of the given application ID.

Query String Params

Returns a list of store listing objects for the primary SKU of the given application IDs.

Query String Params

Returns the store listing object for the given SKU ID.

Query String Params

Returns a list of subscription plan objects for the given SKU ID. User must own the SKU's application or be a member of the owning team.

Returns a list of published subscription plan objects for the given SKU ID.

Query String Params

¹ To access unpublished subscription plans, the user must own the SKU's application or be a member of the owning team.

Revenue Surface

Returns a list of published subscription plan objects for the given SKU IDs.

Query String Params

¹ To access unpublished subscription plans, the user must own the SKUs' application or be a member of the owning team.

Returns an invoice object representing a purchase preview for the given SKU ID.

Query String Params

Creates a new purchase for the given SKU ID. Fires an Entitlement Create and Payment Update Gateway event.

JSON Params

¹ If required, this URL is typically set to the Create Billing Popup Bridge Redirect endpoint with a response_type of return, which redirects the user back to the Discord client for handling.

² If the actual currency or amount charged does not match these expected values, the purchase will fail.

³ See the section on payment clients for more information.

Gift Info Options Structure

Response Body

Returns a list of store asset objects for the given application ID. User must be the owner of the application or member of the owning team.

Uploads a new store asset for the given application ID. Returns the created store asset object on success. User must be the owner of the application or developer of the owning team.

Form Params

Deletes the store asset with the given ID. Returns a 204 empty response on success. User must be the owner of the application or member of the owning team.

Returns a list of integers representing the available store price tiers.

Query String Params

Price Tier Type

Returns a map of lower-cased ISO 4217 currency codes to integer prices representing localized pricing for the given price tier.

Returns a EULA object for the given ID.

Returns the store layout of the given application ID.

Response Body

Modifies the SKU publishing states for the given application and SKU IDs.

JSON Params

Storefront Publish State

Response Body

Returns the pricing information for a consumable SKU. These are currently as follows:

• HD Streaming (1285377810587979827)
• Confetti (1316162456959057920)

Response Body

Returns the active HD streaming potion entitlement for the user.

Response Body

Applies an HD streaming potion to a voice channel. Returns a 204 empty response on success. Fires a Channel Update Gateway event.

JSON Params

Returns the active confetti potion entitlement for the user.

Response Body

Applies a confetti potion to a message. To use custom emoji, you must encode it in the format name:id with the emoji name and emoji ID. Returns a 204 empty response on success. Fires a Message Update Gateway event.

JSON Params

Returns the current user's Orbs balance.

Response Body