How to fix widgets cannot be added on home screen error

Problem

When adding a widget, you may see this message:

“Please wait for the white box indicator”

This usually means the widget does not fit in the selected area of your home screen.

---

Cause

Widgets have a fixed size (width × height in grid cells).
If the widget is larger than the available space on your grid, it cannot be placed.

---

Solution

1. Check the widget size

In the widget picker, look for the size label (example: 1×4).

• First number = columns (width)
• Second number = rows (height)

Example:

• 1×4 = 1 column wide, 4 rows tall

---

2. Check your grid size

Compare the widget size with your home screen grid.

Example:

• Grid: 5×5
• Widget: 1×6

This will fail because:

• The widget needs 6 rows
• The grid only has 5 rows

---

3. Try placing the widget from the left side

Widgets are placed starting from the top-left corner (position 0,0) of the grid.

• Try dragging the widget to the leftmost side
• You'll see a white box indicating that the position is valid to drop.

---

Summary

• The widget must fully fit within the grid
• Placement starts from the top-left, so position matters

If it still fails, clear space or file an issue.