Skip to main content

Troubleshooting a Flow

Learn how to fix errors with your flows

Holly Conrad Smith avatar
Written by Holly Conrad Smith
Updated this week

Flows are extremely powerful. With great power comes great responsibility - sometimes flows can cause errors in your projects.

Learn how to find and fix flow errors for optimal project performance.

How do I know something isn't working?

Geometry Error

If there is a geometry error, the affected feature will appear neon magenta on the map.

Engine Failure

Sometimes the flow might break the rendering for some or all of the geometries in your project. You will see an engine status error in the bottom left corner of your Giraffe tab.

Try pausing and re-starting the engine (click the pause button to the left of the error text).

If pause and restart doesn't work, try removing the flow from geometries in the project.

Crash

Sometimes, a flow error will completely crash your Giraffe tab. (Usually this happens when you have self-referencing nodes or a bad loop).

Try refreshing the tab. If you are unable to get back in, reach out to support for assistance retrieving the file.

Troubleshooting steps

Spectacles

Turn on the Spectacles from the top bar. This displays the state of all nodes in the Flow.

Review Warnings and Errors

Any nodes with an error will appear in Red. Red nodes mean the entire flow is failing due to the error.

Any nodes with a warning will appear in orange. Orange nodes mean that the flow is still able to complete, but some information may be missing.

Read the Status

If a node has an error or a warning, you may want to use the Reader node to review the status.

Add the Reader node to the Status (S) output of the node with the error/warning to see the message.

Pause Nodes

Try pausing a specific node to see if it is causing the issue. Right click on the node title -> Disable.

Pause Engine

Pause the entire Giraffe engine to stop all geometry generation.

Click the pause button in the top bar of the flow editor.

Recompute

If processing seems stuck, try clicking recompute. This stops the flow process and restarts it.

Refresh Tab

If all else fails, try refreshing your browser tab.

Did this answer your question?