Troubleshooting: Dashboard Layout
Widgets overlap or stack unexpectedly
Probable cause: The grid prevents overlapping, so this usually means widgets were pushed during a resize. The grid automatically moves widgets to avoid collisions.
What to do:
- Switch to edit mode.
- Drag widgets to your desired positions. They'll snap to the grid.
- Save after arranging.
Widget won't resize smaller
Probable cause: Widgets have a minimum size of 2 columns wide and 2 rows tall.
What to do: This is a fixed minimum and can't be reduced. If you need a smaller display, consider using CSS within the widget to reduce the visible content area.
Widget appears too large
Probable cause: The widget's Max Width or Max Height settings may not be set, allowing it to stretch to fill available space.
What to do:
- Open the widget in the editor.
- Go to the Settings tab.
- Set Max Width and Max Height to appropriate values.
- Save the widget, then return to the dashboard.
Layout looks different on mobile
Expected behavior. On small screens, the dashboard stacks all widgets vertically in a single column. The grid layout only applies on desktop-width screens.
Changes aren't saved
Probable cause: You didn't click Save after rearranging.
What to do: Look for the red dot on the Save button — it indicates unsaved changes. Click Save to persist the layout.
Widget shows blank on the dashboard
See Troubleshooting: Widget Issues — the most common causes are data connection access issues or JavaScript errors.