Skip to content
Blanc edited this page Apr 3, 2026 · 4 revisions

How to fix widgets cannot be added on home screen error

Problem

When adding a widget, you may see this message:

“Layout was cancelled due to an invalid position or interruption.”

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
  • Make sure there is enough continuous empty space

Even if the grid is large enough, the widget will fail if:

  • The space is blocked
  • The empty cells are not aligned

Summary

  • The widget must fully fit within the grid
  • The space must be continuous and not blocked
  • Placement starts from the top-left, so position matters

If it still fails, clear space or choose a smaller widget size.

Clone this wiki locally