Skip to main content

Troubleshooting a Flow

Learn how to fix errors with your flows

Written by Holly Conrad Smith
Updated over a week ago

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?

Flow Error

If there is a flow error, the affected feature will appear neon magenta / bright pink 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.

Review Errors and Warnings

Understanding error codes can help you troubleshoot what is not working

Error

What it means

How to fix

Cannot read properties of undefined

Missing inputs

Add the correct input data by connecting another node

null

The output value of the node is Null

Check the input data type and/or logic to ensure the node can process a result

Typical Problems

Missing an Input value

Data type mismatch

Providing a List when Single Object is expected

Did this answer your question?