Diagnosing Auto Layout Frames That Collapse or Clip in Figma

The problem: a frame that disappears or clips its content

You hide a layer inside an Auto Layout frame, and the parent collapses to a thin line. Or you edit a text layer in a card component, and the last line is cut off instead of pushing the frame taller. These are the two most common Auto Layout surprises in Figma: unexpected collapse and unexpected clipping.

Auto Layout is Figma's layout engine for frames that resize based on their children. A frame set to Hug contents shrinks or grows to fit its children along that axis. A frame set to Fill container stretches to fill the parent along that axis.

The useful takeaway: diagnose one axis at a time. Check the parent's hug or fill setting, then each child's resize behavior, then look for absolute positioning or fixed text layers. Most issues trace to one of those four settings.

Recognizable conditions and likely causes

Symptom	Likely cause	Where to check
Parent shrinks to near zero when a child is hidden	Parent axis set to Hug contents; child has no fixed size	Auto Layout panel, direction and resize behavior
Text is clipped inside a Hug parent	Text layer set to fixed width or fixed height	Text layer resizing controls in right sidebar
Child overflows without resizing parent	Absolute position enabled on child	Position section, right sidebar
Parent will not shrink below a set size	Minimum width or height set on Auto Layout frame	Auto Layout panel, min dimensions
Overflow or clipping appears only in nested frames	Mixed Hug and Fill settings across parent and child axes	Auto Layout panel on each nested frame

Check the affected frame first

1. Open the Figma file in the desktop app or browser. Select the frame that resizes unexpectedly. You need edit access to the file to change layout settings.
2. In the right sidebar, locate the Auto Layout section. Confirm the direction (vertical or horizontal) and the resize behavior for each axis: Hug contents or Fill container.
3. Select each child layer inside the frame. Check its width and height controls in the right sidebar. Note whether any child is set to a fixed pixel size, Fill container, or Hug contents.
4. Toggle the visibility of each child by clicking the eye icon in the layers panel. Watch the parent frame. If it collapses to near zero, the parent is likely set to Hug contents with no minimum dimension.
5. In the right sidebar, look at the Position section. If Absolute position is checked for a child, that layer is excluded from Auto Layout calculations and can overflow without resizing the parent.
6. Select any text layers. Check whether width or height is fixed. Fixed text layers do not auto-expand, so a Hug parent may clip them instead of growing.
7. Open Dev Mode and choose Inspect. Select the same frame and compare the reported CSS width and height against the Figma frame dimensions. A mismatch often signals a hug or fill conflict or an absolute-positioned child.

Fixes matched to each finding

• Parent collapses when a child is hidden: Set a minimum width or height on the parent frame in the Auto Layout panel, or change the child from Hug to a fixed size so the parent always has content to wrap.
• Text clipped in a Hug parent: Change the text layer to auto width or auto height, or change the parent axis to Fill container so it can expand around the text.
• Absolute-positioned child overflows: Uncheck Absolute position if the child should participate in layout. If it must remain absolute, for example a badge overlay, add padding to the parent or accept that the parent will not resize for that layer.
• Parent will not shrink below a threshold: Lower or remove the minimum width or height value in the Auto Layout panel.
• Nested frames overflow or clip: Align the inner frame's axis setting to the parent's expectation. A Fill container child inside a Hug parent often causes overflow; set the child to Hug contents or give the parent a minimum size.

Risk: changing Auto Layout settings on a main component affects every instance of that component across the file. Test on a detached instance first if you are unsure.

When to escalate

• The issue remains after checking every axis, child, and min-dimension setting.
• The frame behaves differently in the Figma desktop app than in the browser. Verify in the environment your team uses for handoff.
• The frame is a library component with variants or properties controlled by a design system team. Contact the library maintainer instead of editing instances directly.
• Engineers need CSS output that matches Figma exactly. Auto Layout is not CSS flexbox; do not assume pixel-perfect parity when handing off.

Limitations and how to verify

Figma Auto Layout behaves like a layout engine, but it is not identical to CSS flexbox. Avoid assuming that a Figma frame will produce identical CSS in a web implementation.

The desktop app and browser version can render layout differently. Verify the behavior in the environment your team uses for review and handoff.

Auto Layout behavior may change between Figma updates without a major version announcement. Re-test after significant edits or after updating the desktop app.

Practical verification: select the frame, open Dev Mode Inspect, and confirm that the reported dimensions match your design specification. If they do not, revisit the hug or fill settings on the parent and each child.