> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryflowy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Flowy is a node-based AI creative platform: you generate images, video, audio, 3D and vector on an infinite Canvas, refine on the Studio timeline, and export or publish from the same project.
> Prefer the Flowy MCP server (https://mcp.tryflowy.ai/mcp) or the REST API at https://apis.tryflowy.ai/v1 for programmatic work. Install with `flowy mcp install` from the @flowy/cli package.
> Credits are workspace-scoped. Generations reserve credits on start and only deduct on success, so failed runs refund automatically.

# Auto Layout

> Tidy the whole canvas in one action, arranging connected flows and loose nodes so the graph reads clearly.

Auto layout rearranges every node on the board at once, connected chains flow left-to-right in the order they connect, and anything not wired to anything else packs into a tidy grid alongside them. It never changes what's connected to what; it only moves nodes.

## Run it

Click **Auto layout** in the left toolbar, or press <kbd>⇧</kbd> <kbd>O</kbd>, to lay out the whole canvas. To tidy just part of the board instead, select a frame or a multi-selection of nodes and click **Auto layout** in the floating selection action bar: only the selected nodes move.

## When to use it

Reach for it after a burst of node creation. A storyboard that fanned out into a dozen scene nodes, an AI assistant run that dropped several generations onto the canvas, or any point where new nodes have piled up overlapping or scattered. Auto layout turns that into a readable graph in one step, instead of dragging nodes into place by hand.

## How it arranges things

* **Connected nodes**: any chain of nodes wired together lays out left-to-right, sources on the left and their dependents to the right, so you can read a pipeline the way you'd read a diagram.
* **Loose nodes**: anything with no connections packs into a compact grid rather than being scattered.
* **Frames**: a grouped frame moves as a single rigid block; its children keep their existing arrangement inside it and aren't re-laid-out individually.

Everything is packed non-overlapping, so a single pass produces a clean board without a second cleanup step.

## From the AI assistant

The [AI assistant](/canvas/ai/overview) can trigger the same layout as an `arrange` action. Useful after it builds out several connected nodes for you, so the result lands tidy instead of stacked. You can also ask it to arrange only a specific selection of nodes rather than the whole board.

## From the API

The Flowy MCP server exposes a `layout_canvas` tool for automations built outside the app: point it at a project, and it lays out every node in a left-to-right layered arrangement following the connections between them, or top-to-bottom, if you ask for the vertical direction instead.