Graph

The Graph layout draws every task the view finds as a dot, joined to its project and milestone, so you can see the whole workspace - or one corner of it - at once. z g.

It works wherever tasks do: the Tasks page, a saved view, a project's or milestone's tasks, a view in a Space. The query bar and filters decide which tasks are drawn, as in every layout.

#Reading it

The graph is drawn on a dark sky, the way Obsidian draws a vault: the work that belongs together pulls together.

• A finished task is a filled dot, an open one a ring. Colored by status, work in progress glows.
• Projects are the bright dots each cluster gathers around, in their own color. Milestones are green once finished, a ring while open.
• Names show on the bigger projects and milestones, and more come out as you zoom in.
• The legend in the bottom corner says what each dot means.

#Moving around

• Drag the background, or scroll, to move around, as on the Canvas. Shift+scroll moves sideways.
• Pinch, or Ctrl/Cmd+scroll, to zoom in and out about the pointer, and double-click to zoom in there.
• The +, - and Fit buttons in the corner zoom too. 100% is the whole graph; Fit goes back to it.
• Zoomed in, each dot shows its key (T-0042), and further in a card with its title and status.
• Click a task for Open and Open in Canvas (the task and everything connected to it, on the Canvas). It lights up with what it's joined to. Click a project or milestone to light it up, with Open.

#The sidebar

Details (]) shows and hides the sidebar: the projects, milestones and labels in the graph, each with how many tasks it holds. Close it with its X. While it's closed, a Show details button sits above the zoom buttons in the corner to bring it back, and Display has a Details sidebar switch. Click one to light it and its tasks up - the rest dims - and fly there. Click it again to see everything. On a phone it starts closed, leaving the screen to the graph.

Ones you've put in a folder (on the Projects or Milestones hub, or in Settings for labels) are listed under it, with the ones in no folder after them. Click a folder's name to light up everything in it and fly there, with all of it in view, and its arrow to close or open it. Which folders are closed is kept on this device, with the toolbar's choices.

#The toolbar

• Color - color the dots by Project, Status or Label.
• Lines - which lines to draw, as on the Canvas: Blocks, Parent of and Related links between tasks, and Labels. Each has an eye: open to show it, closed to hide it.
• Labels puts each label in the graph as a diamond that pulls on its tasks: tasks that share a label drift toward each other, and the dots glide to their new places. Its lines stay faint until you point at or click the label. Turn it off and they glide back to their projects.
• Show - Names on projects and milestones, and Live (below).
• Details - the sidebar of projects and milestones (]).
• Share this graph - see below.

Display (z v) has the same choices, and the Details sidebar switch, all in one place.

These are kept on this device for each view, like a zoom: they're about looking, not part of the view. When the toolbar is too narrow for them all, Color, Lines, Show, Details and Share this graph fold into one Graph menu (on a phone, for one).

#Live

With Live on, a task anyone finishes ripples green where it sits, and the corner says who finished it and where - "JR finished a task in Vertex Flow".

#Sharing a graph

Share this graph opens the share sheet. Pick:

• What - All time, or This week; from a finished milestone's popup, that milestone too.
• As - a Time-lapse (six seconds: tasks appear the day they were made and fill in the day they were finished), a Picture, or a Live embed that keeps itself up to date.
• Shape - Wide (the size a link preview takes), Square or Story (for Instagram and TikTok). The graph is laid out to fill that shape, and the shared page shows it in that shape too. Square and Story keep their words clear of the bottom (and Story of the top and right edge too), where apps lay their play controls, captions and buttons over a video.

The preview on the left is what people will see. Nothing is shared until you make it:

• Share a link - pick when it Turns off, name it if you like (only you see the name, in Shared links), then Make the link. It's copied as it's made, and its address shows with Copy link. Changing anything above it afterwards makes a new link.
• Or download it - Download video saves an MP4 and Download image a PNG, to post wherever you like. No link is made. You name the file first: type a name (or keep the one it suggests) and press Save or Enter. Escape or Cancel goes back without saving.

For a Live embed, Make the embed gives you a line to paste into a README, a Notion page, your site or a doc here (it shows as the picture).

A shared graph holds shapes and counts only - never a task's name. Project and milestone names show only if you tick Show project and milestone names. Tasks in a Space a guest has been added to - client work - are left out unless you untick Leave out Spaces with guests, and internal tasks are always left out. A picture or time-lapse is a snapshot from the day you made it. A live embed draws the graph as it is each time it's opened, and its page keeps up while it's open: a change shows within about 15 seconds. Like every link, it shows up in Shared links, where you can turn it off.

#When a milestone is finished

Completing a milestone with finished tasks in it shows how it came together: the whole graph, zoomed in on it, its tasks lighting up in the order they were finished, with Replay, Share the time-lapse and Copy link. Untick Show this whenever a milestone is finished to stop it, or turn it off and on in Settings > Preferences.

#Elsewhere

• The workspace's home (the screen with no tab open) shows a small live graph of everything. Click it to open the Graph layout. In a new workspace it starts empty, with Create task, and fills in as you add tasks, projects and milestones.
• A dashboard can have a Graph widget.

Thousands of tasks stay smooth: the graph is drawn on a canvas.