Homepage widget error: widget failed to load on homepage

The widget's underlying data source (table, view, or report) has been deleted or renamed, causing the widget to fail when querying for data. (high likelihood)

A JavaScript error exists in the widget's client script or server script that prevents proper execution and rendering of the widget content. (high likelihood)

The user lacks sufficient ACL permissions to read from the table or execute the query that the widget depends on for its data. (medium likelihood)

The widget configuration has become corrupted or contains invalid parameters, such as malformed JSON in widget options or invalid field references. (medium likelihood)

A system update or customization has modified core tables or fields that the widget references, breaking the widget's functionality. (low likelihood)

Step 1: Navigate to System Diagnostics > Log > Application Log and filter by the current user and timeframe to identify any JavaScript errors or permission violations related to the widget.

Step 2: Open the browser developer console (F12) and refresh the homepage to check for client-side JavaScript errors that might indicate widget script issues.

Step 3: Go to System UI > Homepage and locate the failing widget, then click to edit it and verify that all referenced tables, fields, and data sources still exist in the system.

Step 4: Check the widget's server script by opening the widget editor and looking for syntax errors, undefined variables, or references to deleted objects in the script code.

Step 5: Verify user permissions by impersonating the affected user and testing the widget, or check ACLs on the tables the widget queries using Security > Access Control (ACL).

Step 6: Test the widget's underlying query by manually running it in the table list view with the same filters and conditions to ensure the data source is accessible.

Step 7: If the widget uses custom options or JSON configuration, validate the syntax and structure of these parameters in the widget preferences section.

Step 8: Create a new instance of the same widget type as a test, and if it works, replace the corrupted widget with the new one to restore functionality.