Why Is Figma Auto Layout Wrap Not Working?

With wrap on, auto layout pushes any child that doesn't fit onto the next line. Once it's on, you get two gap fields: one between items in a row and one between rows. Wrap is part of the Horizontal flow only. Vertical flow doesn't offer it, and the Grid flow places items in fixed cells and doesn't wrap at all.

Select the auto layout frame and pick the Horizontal direction in the right sidebar, then turn on wrap. If you were using Grid, decide which you need: Grid gives you rows and columns with spans, wrap gives you a row that reflows as it fills. See auto layout grid for the Grid flow.

This is the fix from the Figma forum thread on the wrap feature. A child set to Fill container grows or shrinks to fill whatever space is left in the row. Because it can always shrink, the row never overflows, and nothing wraps. Open the child's Width dropdown, choose Add min width, and type the smallest size it should reach. When the row can't fit that width any more, the child moves to the next line.

This is the usual setup for responsive card grids: every card on Fill container with a min width, and the parent on wrap.

Wrapping happens when items run out of room in the parent's width. If the parent is set to Hug contents, it can grow to fit every child in one row, so nothing ever overflows. Setting the parent to a fixed width, or to Fill container inside its own parent, gives the row a limit to wrap against. Figma's help center doesn't spell this rule out, so treat it as a tip and test it on your frame. The sizing modes are explained in Fill container vs Hug contents.