Otterdock Desktop Widgets on macOS: Setup, Sizes, Limits and Fixes

Control-click the desktop, choose Edit Widgets, drag an Otterdock widget onto the desktop (or add it in Notification Center), then Edit Widget to pick the group. Small shows the first 4 items, medium 8, large 12, in the order set in the group editor. Each tile opens one item; there is no launch-all tile. Widgets read a snapshot the app writes, so edits appear after the app saves and macOS refreshes the widget, which can take up to 15 minutes unless you remove and re-add it.

Since macOS 14 Sonoma, widgets can sit directly on the desktop, not only in Notification Center. Otterdock uses that to put a group where you can see it without opening the Dock: a grid of your project's apps, files, folders and links, one click each. This guide covers setup, what each size holds, how refresh actually works, and the handful of problems people run into.

Before you start

• macOS 14 or later. Desktop widgets do not exist on earlier versions.
• Otterdock installed (either edition) with at least one group that has items. Widgets show nothing for an empty group.
• Widgets work the same in the Direct and Mac App Store editions and never need Accessibility permission. The edition differences are elsewhere; see Direct vs Mac App Store.

Add a widget to the desktop

1. Control-click (or right-click) an empty spot on the desktop and choose Edit Widgets.
2. In the gallery, type "Otterdock" in the search field, or scroll to Otterdock in the app list.
3. Drag the Small, Medium or Large widget onto the desktop. You can also click a size to place it automatically.
4. Click Done at the bottom of the gallery.
5. Control-click the new widget and choose Edit Widget. Pick the group from the list and click outside the widget to close the editor.

The widget fills with the group's items. Click a tile to open that app, file, folder or link.

If Otterdock does not appear in the gallery, open Otterdock once so macOS registers its widget extension, create a group with at least one item, then reopen the gallery.

Add a widget to Notification Center

1. Click the date and time in the menu bar (or swipe left from the right edge of the trackpad with two fingers).
2. Scroll to the bottom and click Edit Widgets.
3. Find Otterdock, drag a size into Notification Center, click Done, then Control-click the widget and choose Edit Widget to pick the group.

Notification Center widgets are useful when the desktop is covered by windows: one click on the clock shows the group over everything.

Sizes and capacity

Items appear in the order set in the group editor, so drag the ones you want in the widget to the top. A group with more items than tiles shows the first N; the rest are still in the group, just not in that widget.

Capacity is fixed by size in both the free and Pro tiers. What Pro changes is how many items a group can hold: on the free tier a group tops out at 8 items, so a large widget on a free group has 8 tiles filled and 4 empty. The limits are spelled out in Free vs Pro.

One tile, one item

Every tile is an independent button. Clicking an app launches it, clicking a file opens it in its default app (or the group's custom opener in Direct Pro), clicking a folder opens it in Finder, clicking a link opens it in your default browser. There is no "launch everything" tile.

That is a platform rule, not an Otterdock choice: a macOS widget tap triggers exactly one intent. If you want the whole group open in one action, use Command-A in the Direct edition's popup, or the Launch Group action both editions expose to the Shortcuts app. Open multiple apps at once on Mac compares those options with Login Items and plain Shortcuts.

How refresh works (and why a widget can lag)

Widgets do not read Otterdock's database directly. When you save a group, Otterdock writes a small snapshot of every group (names, item order, icons) to a shared container that the widget extension can read, and asks macOS to reload Otterdock widgets. The widget also schedules its own reload at least every 15 minutes.

In practice an edit shows up within seconds. When it does not:

1. Make sure the change was saved in the group editor (the Dock sync indicator, in Direct, is a good sign the save happened).
2. Give macOS a minute. Widget reloads are batched and deferred on battery or under load.
3. Control-click the widget, choose Edit Widget, and reselect the same group. That forces a reload.
4. If it is still stale, remove the widget (Control-click > Remove Widget) and add it again.

Because the widget reads a snapshot, it keeps working while Otterdock is not running. Launching an item from the widget hands the request to Otterdock, so the first click after a restart can take a moment longer while the app starts.

Troubleshooting

Widgets vs the Dock

A widget and a Dock entry can show the same group, and many people use both: the Dock for the keyboard-and-pointer flow, a widget on a second display or in Notification Center for glanceable access. The differences:

• The Dock entry (Direct popup or native stack) can show every item and, in Direct, has search and Command-A. A widget shows at most 12 and opens one at a time.
• A widget stays visible on the desktop even when the Dock auto-hides.
• Widgets need no permission; Direct's custom popup needs Accessibility.

For how groups get into the Dock in each edition, see adding Otterdock groups to the Mac Dock, and for a complete two-group setup that uses both, workflow groups on the Mac Dock.