Skip to content

Help

Troubleshooting

Quick checks for a missing Dock, widget permissions, or an integration that won’t connect.

On this page

Why can’t I see widgets?

Widgets are only available in Custom Docks. If your setup is macOS Dock only, Dockset manages Apple’s Dock, which cannot display Dockset widgets.

  1. Open Manage Docks… from Dockset’s menu bar icon.
  2. Select a Custom Dock profile. If you do not have one, open the profile selector and choose New profile → Custom Dock.
  3. Use the editor’s add menu and choose Widget… to add a widget.
  4. Open Settings → Dock setup and choose macOS Dock + Custom Dock to keep Apple’s Dock alongside your widgets, or Custom Dock as your main Dock.
  5. Under Custom Dock, select the profile you added the widget to.

If the Dock is still hidden, check its Display and Position. With Automatically hide enabled, move the pointer to that screen edge. With Use as desktop widget enabled, the Dock stays behind app windows. Hide when macOS Dock appears also temporarily hides it when Apple’s Dock appears on the same edge.

Dockset has its own widget library. Apple’s desktop widgets and third-party WidgetKit widgets cannot be added. If a widget is visible but has no data, open it to finish setup or check the permission and connection help below.

See the full apps and widgets guide.

My Custom Dock is missing

  • Open Dockset and check its menu bar icon.
  • In Settings, check that Dock setup includes the Custom Dock and a custom profile is selected.
  • Check the selected display and screen edge. If auto-hide is enabled, move the pointer to that edge.

Compare the available Dock setups.

Minimized windows or previews are missing

Enable Show minimized windows in the Custom Dock’s Settings; Show running apps does not enable it. Allow Accessibility access so Dockset can find and restore windows.

If an item appears with a window symbol instead of a screenshot, allow Screen Recording for Window previews on macOS 14 or later. Restore the window once, then minimize it again so Dockset can capture it. Cached previews survive Dockset restarts, but a window minimized before its first capture may have no image. Read about minimized windows.

Calendar or Reminders cannot show my data

Open the widget and allow access when macOS asks. If you previously denied it, open System Settings → Privacy & Security, find Calendar or Reminders, and allow Dockset access. Return to the widget and check its selected calendars or lists.

Permissions are separate for each feature. App badges and minimized-window controls use Accessibility access; window previews and optional smooth switching use Screen Recording. Grant the permission requested by the feature you want to use.

See Calendar and Reminders setup for selecting calendars and lists, or Now Playing connection help for music controls.

A business widget won’t connect

Check the exact credentials and permissions for your provider:

Check your internet connection and whether a key has expired or been revoked. Live and sandbox accounts contain different data. Never paste your keys into this website or a support message.

The widget shows old or unexpected numbers

Use the widget’s Refresh control and look for an error or last-updated time. If a refresh fails, the last successful values can remain visible. Check the account, metric, date range, currency, and time zone before comparing with a provider’s dashboard. Each integration guide explains its definitions.

For AI Usage, check how each provider updates. Claude Code limits may stay unchanged until another status-line update; the connected Desktop fallback can refresh account limits instead. The AI guide also explains Cursor, Gemini, and Copilot setup.

The Dock is not transparent

Choose Liquid Glass and Clear, then check macOS display accessibility settings. Follow the transparency checks.

Still stuck?

Contact support with what you expected, what happened, the exact error, and your macOS and Dockset versions. Include a screenshot if it helps, with account secrets and license keys hidden.