Skip to main content

Widgets

Widgets are the primary content blocks on MyDash dashboards. MyDash integrates with the Nextcloud Dashboard Widget API (v1 and v2) to discover all registered dashboard widgets across installed apps.

Features

  • Discover widgets from all installed Nextcloud apps via IManager
  • Support for v1 (IAPIWidget) and v2 (IAPIWidgetV2) widget APIs
  • Widget placements track grid position, styling, and visibility
  • Custom title and icon override per placement
  • Style configuration via JSON blob (borders, colors, etc.)
  • Compulsory flag for admin-mandated widgets

API Endpoints

MethodEndpointDescription
GET/api/widgetsList available widgets
GET/api/widgets/itemsGet widget items
POST/api/dashboard/{id}/widgetsAdd widget to dashboard
PUT/api/widgets/{id}Update widget placement
DELETE/api/widgets/{id}Remove widget placement

Screenshot

Dashboard with Widgets