discord-widgets

Introduction

discord-widgets is a minimal, zero-dependency TypeScript wrapper around Discord's new profile widget feature. Draft, publish and sync widgets which appear on the Board portion of a users profile.

The board is visible on the right side of a user's profile, and while only previously reserved for pre-created widgets, with the help of Discord Dataminers and the 2026-03-widget-config-editor experiment; users can now create their own widgets with this information.

Widget availability

Recently (6/3/26), Discord restricted the ability to apply custom application widgets to only being able to be applied to users who created the application and/or isn't on the team with the application with atleast developer access. This means you will only currently be able to apply widgets to yourself and not to others.

Prerequisites

  • Discord application created inside of Discord's Developer Portal
    • Discord application must be allowed to use Discord Social SDK intents
    • Apply for using intents instantly in the Developer Portal (putting in fabricated information still works!)

Installation

npm install discord-widgets

Optimally, TypeScript types are provided if needed. You will have a much easier time if you use TypeScript.

On this page