# The drag & drop canvas ## Introduction The process flow canvas has six main elements: [title bar](#process-flow-title-bar), [actions bar](#process-flow-actions), [layout options](#layout-options), [build area](#build-area), [shapes panel](#shapes-panel), and a [flow navigator (minimap)](#flow-navigator). For example:

Once you start adding [shapes](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes) to a flow, you'll also encounter the [settings drawer](#settings-drawer). For example:

The following sections summarise these areas. ## Process flow title bar The process flow title bar shows the process flow name, as specified when it was created. The number above the title is the process `flow id` , and the number below is the `version` number. To change this title, use the [settings option from the actions bar](#settings). The `copy link with current company id` icon to the right of the title can be used to copy a link to this process flow, which includes the `id` for your company profile:

This is useful if: * You manage multiple Patchworks profiles. Sharing this link with other team members (who have sufficient permissions) allows them to access the process flow directly - seamlessly switching to the relevant company profile. * You need to raise a support query regarding a process flow. Including this link in your support ticket means that a member of our Support team can access the flow more efficiently, seamlessly switching to the relevant company profile. ## Process flow actions Options in the actions bar are summarised below:

Option	Summary
	Process flow settings Use this option to access general settings for this process flow. For more information, please see Process flow settings.
	Return to trigger If you're working on a longer process flow, use this option to quickly jump back to the start (i.e. back to the trigger shape).
	Initialise flow now Use this option to run the process flow manually (rather than waiting for a trigger to be invoked). For more information, please see Running a process flow manually.
	Initialise flow (advanced) Use this option to run the process flow manually with a given payload. This is particularly useful for testing - for example, if you want to test how a flow will run with expected data from a Patchworks API request. If the virtual environments feature is enabled for your company profile, you can also use this option to test a process flow against a given virtual environment.
	Stop the current run If a process flow is running, you can use this option to stop the current run. Stopping a run in this way triggers the flow to stop at its next step. If an API call or script has already been triggered, the process flow will stop after these have completed. With this in mind, it's important to check any target connections to clarify what (if any) updates have been made after a process flow has been stopped.
	Logs & payloads Toggles the `details` panel off/on. As the process flow runs, you can view progress in real time; you can also check logs and view payloads at any stage.
	Toggle new canvas If you're currently working with the classic canvas, use this option to switch to the new canvas. You can switch back at any time. Note that if you switch from the new canvas back to classic, any disconnected shapes are NOT displayed in classic flow.

## Layout options Layout options are summarised below:

Option	Summary
	Snap to grid Toggle this option on for precise shape placement (shapes align with the grid as they are added).
	Auto layout Arranges all shapes into a 'clean', readable layout, automatically.
	Layout direction Toggle between vertical (top-to-bottom) and horizontal (left-to-right) layouts.
	Fit to viewport Zoom out to see all steps in the flow.

## Build area The main 'build area' is where you build your process flow. Start by clicking the `+` sign associated with the [trigger shape](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/trigger-shape), then choose the required shape for your next step, and [start building](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows)!

Alternatively, use the [shapes panel ](#shapes-panel)to drop shapes onto the canvas, ready to connect/configure later. {% hint style="info" %} For more information about techniques for working with the canvas as you build a flow, please see [Canvas interactions](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/the-process-flow-canvas/the-drag-and-drop-canvas/drag-and-drop-canvas-interactions) and [General canvas features](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/the-process-flow-canvas/broken-reference). {% endhint %} {% hint style="info" %} We're adding new shapes all the time! For information about working with shapes, please see our [Process flow shapes](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes) section. {% endhint %} ## Adding shapes for a process flow You can add shapes to the canvas in several ways: * [Copy/paste existing shapes](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/the-process-flow-canvas/drag-and-drop-canvas-interactions#copying-and-pasting-shapes) * [Use the shapes panel to drag and drop shapes anywhere on the canvas](#the-shapes-panel) * [Use the shapes palette to add a shape at a specific point in the flow](#the-shapes-palette) ### The shapes panel You can drag shapes from the shapes panel and drop them anywhere on the canvas, ready to configure/connect later.

Show me

This is a great way to start building a flow if you don't want to commit the shapes to a structure just yet. {% hint style="info" %} If you want to add a shape to a specific point in the flow, use the `+` icon at the required point and choose from the [shapes palette](#the-shapes-palette). {% endhint %} All [standard](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes) and [advanced](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes) shapes are available from the shapes panel - scroll the list, click the shape you need, and drag it out to the canvas. Alternatively, you can use shape panel options find the shapes you need:

Shape panel options are summarised below:

#1	Summary
1	Collapse the shapes panel.
2	Use the `search` field to search by shape name (the search is not case sensitive).
3	Shapes are categorised into `logic`, `data`, `connect`, and `utilities` groupings. Select a category to view applicable shapes.
4	Drag from your most recently used shapes.
5	Scroll listed shapes and drag to the canvas.

### The shapes palette If you want to add a shape at a specific point in your flow, click the `+` icon at the point you want to place it, for example:

...then choose the type of shape to add:

Depending on the shape, the settings panel will either open immediately so you can provide details before the shape is added to the canvas, or the shape is added to the canvas and you can [update settings](#updating-shape-settings) when you're ready. ## Flow navigator (minimap) A minimap is always displayed in the bottom, right-hand corner of the canvas. This is a small, zoomed-out thumbnail of your entire flow. It's particularly useful for quick navigation when working with longer, more complex process flows. For example:

A highlighted box within the minimap shows exactly where your current viewport is positioned relative to the full flow. Drag this box up/down/left/right to jump to different parts of the flow, without having to scroll or pan across the main canvas. ## Settings drawer When you access [process flow settings](#settings) or configure a shape in your flow, available settings are displayed in a panel on the right-hand side. For example, when we choose to access settings for a [trigger ](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/trigger-shape)shape, available trigger options are displayed: