You want to quickly see your Discord messages or jump into a voice channel without unlocking your iPhone and opening the app. The Discord mobile widget for iOS gives you glanceable information and one-tap actions right from the lock screen. This article explains how to add the widget, what information it shows, and how to use it for fast access to your servers and DMs.
Discord’s iOS widget is available in two sizes: a small square and a medium rectangle. Both display your most recent direct messages and mentions, along with the server or channel they came from. The widget updates in real time when your iPhone is connected to the internet. You can tap a message preview to open Discord and reply directly.
Before you start, make sure your iPhone is running iOS 14 or later and you have the latest version of Discord installed from the App Store. You also need to be logged into your Discord account on the device.
Key Takeaways: Discord iOS Widget Setup and Usage
- Widget Gallery > Discord > Add Widget: The only way to place the widget on your lock screen or Home Screen.
- Small vs Medium Widget Size: Small shows one recent message preview; medium shows up to three.
- Tap a Message Preview: Opens Discord directly to that conversation for quick replies.
What the Discord iOS Widget Displays
The Discord widget shows a scrollable list of your most recent notifications. These include direct messages from friends and mentions in servers you belong to. Each entry displays the sender’s avatar, username, and the first line of the message. If a message contains an image or attachment, the widget shows a small attachment icon instead of the file preview.
The widget does not show message content from channels you have muted or from servers where you disabled notifications. It also does not display voice channel activity, such as who is speaking or how many people are in a channel. The widget is read-only on the lock screen — you cannot reply or react without unlocking your iPhone and opening Discord.
The widget refreshes automatically every few minutes when your iPhone is not in Low Power Mode. In Low Power Mode, the widget updates only when you open Discord or force-touch the widget. You can also force-touch the widget to see a quick action menu that includes Open Discord and Search.
Steps to Add the Discord Widget to Your Lock Screen
Follow these steps to place the Discord widget on your iPhone lock screen. The same steps work for adding it to a Home Screen page if you prefer.
- Enter Jiggle Mode
Press and hold an empty area on your lock screen or Home Screen until the icons start wiggling. On the lock screen, you may need to long-press the screen and then tap Customize. - Tap the Add Widget Button
Look for the plus icon in the top-left or top-right corner of the screen. On iOS 16 and later, tap Customize, then tap the widget area above the clock, then tap the plus icon. - Search for Discord
In the widget gallery, scroll down or use the search bar at the top. Type Discord and tap the Discord icon when it appears. - Choose Widget Size
Swipe left or right to preview the small and medium widget sizes. Tap the one you want. Small widgets take up one slot in the widget area. Medium widgets take up two slots. - Tap Add Widget
After selecting the size, tap the blue Add Widget button. The widget appears in your widget area immediately. - Position the Widget
Drag the widget to your preferred location. You can place it above the clock on the lock screen or in the Today View accessed by swiping right from the lock screen. - Tap Done to Save
Tap Done in the top-right corner of the screen. On the lock screen, press the side button to exit jiggle mode. The widget is now active.
Using the Discord Widget From the Lock Screen
Once the widget is added, you can interact with it without unlocking your iPhone — but only to see information. Here is how to use it effectively.
- View Recent Messages
Look at the widget to see the most recent direct message or mention. The widget shows the sender’s name and the first line of the message. If you have multiple unread messages, the widget cycles through them every few seconds. - Tap a Message Preview
Tap any message preview on the widget. Your iPhone prompts you to unlock with Face ID, Touch ID, or your passcode. After unlocking, Discord opens directly to that conversation. - Force-Touch for Quick Actions
Press firmly on the widget. A menu appears with options: Open Discord, Search, and New Message. Tap Open Discord to launch the app to your last active server or DM. Tap Search to open the Discord search screen. - Refresh the Widget Manually
If the widget seems stale, open Discord on your iPhone. The widget refreshes immediately after the app loads. You can also force-touch the widget and swipe down on the preview area to trigger a refresh.
Common Issues With the Discord iOS Widget
Widget Shows No Messages or Is Blank
This usually happens when you have no recent direct messages or mentions. The widget only displays content from conversations where you received a notification. Send yourself a test message from another account or ask a friend to DM you. The widget should update within a few minutes.
Widget Does Not Update After Receiving a New Message
If your iPhone is in Low Power Mode, the widget stops refreshing automatically. Turn off Low Power Mode in Settings > Battery. Also check that Background App Refresh is enabled for Discord in Settings > General > Background App Refresh. If it is off, the widget may not update until you open Discord.
Widget Shows Messages From Muted Servers
The widget shows all notifications that Discord sends to your iPhone, including messages from servers you have muted on desktop. To stop this, open Discord, go to the server, tap the server name at the top, select Notification Settings, and choose Nothing. This prevents the server from sending any notifications to your device.
Widget Disappears After iOS Update
iOS updates sometimes remove third-party widgets. After updating, go back to the widget gallery and add Discord again. Your widget position and size settings are not saved, so you need to reconfigure them.
Discord Widget Sizes: Small vs Medium
| Feature | Small Widget | Medium Widget |
|---|---|---|
| Number of message previews | 1 | Up to 3 |
| Space taken on screen | 1 slot | 2 slots |
| Shows sender avatar | Yes | Yes |
| Shows server name | No | Yes, for each message |
| Quick action menu | Yes, with force-touch | Yes, with force-touch |
Managing Widget Privacy on the Lock Screen
The Discord widget displays message content on the lock screen where anyone can see it. If you want to hide message previews, you can disable lock screen notifications for Discord entirely. Go to Settings > Notifications > Discord and turn off Show on Lock Screen. This removes the widget’s ability to show content on the lock screen, but the widget still appears as a blank placeholder.
Alternatively, you can keep the widget but change your iPhone’s notification preview setting. Go to Settings > Notifications > Show Previews and select When Unlocked. This hides message text on the lock screen for all apps, including Discord. The widget still shows the sender name but not the message body.
Conclusion
You can now add the Discord widget to your iPhone lock screen and see recent messages and mentions at a glance. The small widget shows one message preview, while the medium widget shows up to three. Tap any preview to unlock your iPhone and jump directly to that conversation. If you want more control over what appears, adjust your Discord notification settings per server or use iOS notification preview controls. For even faster access, try adding the widget to your Home Screen instead of the lock screen so you can see it every time you wake your iPhone.