FAQ

Quick answers to the questions that come up most often. If your problem isn’t here, search open issues or file a new one.

Sizing

Why is my Hug element 0×0?

Hug measures the element to fit its children. If the element has no children, the result is its padding alone — 0×0 if no padding either. For text-only leaves, use TextSize instead.

Fix: for text-only elements, type ts (TextSize) into the size field instead of hug. That measures the TMP/Image content rather than children.

See Sizing → Sizing modes for the full mode reference.

Why doesn’t Fill make my element grow?

Fill shares remaining space inside its parent. If the parent’s main-axis size isn’t known (e.g. parent is also Hug along the same axis), there’s nothing to share.

Fix: ensure the parent has a definite size on the axis you’re filling — Pixels, Fill, Percentage, or AspectRatio.

When should I use Fill vs Percentage?

• Fill — share remaining space with other Fill siblings, weighted. Use when you have multiple Fill siblings (sidebar + main pane, header / body / footer).
• Percentage — a fixed fraction of the parent’s axis, independent of siblings. Use when you want a specific ratio (modal at 50% width, hero at 30% of viewport height).

Rule of thumb: if you have more than one stretchable sibling on the axis, you almost always want Fill.

How do I make my Width depend on a Percentage of Height (or vice versa)?

Set one axis to a definite size, and the other to AspectRatio — type e.g. 1.78x (16:9) into that size field. The axis with the aspect mode resolves after the other axis is known.

At least one axis must have a definite size for AspectRatio to resolve.

Layout

Why does .Children(...) overlap my children?

Give the container a real Layout Type — set Layout Type to Row, Column, or Grid. Without one, children aren’t arranged and stack at the same spot.

Why doesn’t my Grid expand when I add more items?

If GridRows is set to a fixed number, items beyond GridColumns × GridRows are clipped.

Fix: leave GridRows at 0 (auto). Rows expand as items overflow.

How do I center a single child?

Set Alignment to center on both axes.

What’s the difference between LayoutType.Absolute and Placement.Absolute?

Two different concepts that share a name:

• LayoutType.Absolute (on the container) — “my children all use absolute positioning by default.”
• Placement.Absolute (on a child, set via .Absolute()) — “I am absolutely positioned inside my parent, regardless of my parent’s layout type.”

A Row container with one Absolute child gets two children laid out via Row, plus the absolute one floating freely.

See Absolute for the full breakdown.

Code-side

Why does .Build() throw on the second call?

A LayoutBuilder is single-use. After .Build() the builder is recycled into a thread-local pool — calling any method on it (including .Build() again) throws InvalidOperationException.

Fix: start a fresh chain via AutoUI.Create() each time you build. Don’t store the builder in a field for reuse.

How do I capture a reference to a built component?

Use .CaptureLayout(layout => myField = layout) for the AutoLayout component, or .Capture(go => myField = go) for the GameObject. For widget components (ListView, Carousel, etc.) the widget builder has its own typed .Capture(view => myField = view).

Why isn’t my layout updating when I change a property?

AutoLayout uses dirty tracking — changes are picked up automatically on the next layout pass (typically the next frame). Three things break this:

1. You modified the underlying RectTransform directly (e.g. .sizeDelta = ...). The engine re-derives sizes each frame and overwrites your changes. Set the AutoLayout property instead (.Width = ...).
2. You changed a serialized field via reflection or in OnValidate without notifying the engine. Call LayoutAdapter.MarkDirty(layout, DirtyType.All) to force a recompute.
3. You’re inside Edit Mode and the engine is paused (e.g. when not in Play Mode and Auto-Refresh is disabled). The engine only ticks during Editor frames; force one with EditorApplication.QueuePlayerLoopUpdate().

If you’ve ruled out the above and the layout still won’t update, file a bug with the layout YAML — that’s the kind of thing the bug-report button was made for.

Components

Why does my ScrollView show no scrollbar?

The package has no built-in scrollbar visuals — you provide the scrollbar handle yourself and assign it to ScrollView.VerticalScrollbarHandle / HorizontalScrollbarHandle. Without an assignment, scrolling works but no thumb is rendered.

See ScrollView for the setup.

Why does my ListView item stay the same size when I change its content?

By default ListView assumes uniform item sizes for performance. After dynamically resizing an item, call m_ListView.InvalidateItemSize(index) (or InvalidateItemSizesFrom(index) for batch updates).

Why doesn’t the Dropdown popup open in the right direction?

Set DropdownDirection.Auto (the default) — it measures available space above/below at open time and picks the larger side. Override with Up / Down only if you want forced behavior.

Distribution

Should I use UPM or .unitypackage for Asset Store distribution?

Both work. UPM is the modern recommendation — it ships Documentation~, supports samples imported via the Package Manager UI, and integrates with semantic versioning. Legacy .unitypackage is simpler for teams not on UPM but loses ~ folders entirely (which means no offline docs).

See the package’s Distribution section for the trade-offs.

How do I report a bug with my exact layout?

Right-click the AutoLayout component header in the Inspector → Report a Bug…. The component’s subtree gets serialized to YAML and pre-filled into a new GitHub issue. See Reporting Bugs.

Do the bundled demo scenes need any third-party assets?

No. The demo scenes shipped in Assets/AutoLayoutPRO/Demos/Scenes/ use flat colors only — zero third-party dependencies. The polished look in the promo videos comes from FlexibleUI by JeffGrawAssets (rounded corners, blur, procedural backgrounds), which is not bundled and used only to dress promotional material.