Flow Validation Errors

Seeing validation errors in your campaign flow? Here's how to identify and fix common flow configuration problems.

Issues and Solutions

Missing Start Node

Every campaign flow requires exactly one start node to define where visitor traffic enters.

Solution:

1. Navigate to the Flow tab in your campaign
2. Check if a start node exists (displayed as a green circle icon)
3. If missing, locate the node palette on the left side of the editor
4. Drag the Start Node onto the canvas
5. Connect the start node to your first segment or variant node

Disconnected Nodes

Nodes exist in your flow but aren't connected to the main flow path.

Solution:

1. Review your entire flow canvas for isolated nodes
2. Look for nodes without connecting lines or that appear grayed out
3. Check for warning indicators on disconnected nodes
4. To connect a node, click and drag from the output handle (small circle on the right edge) to the input handle of another node
5. If a node is unnecessary, right-click it and select Delete
6. Verify every node traces back to the start node
7. Confirm every flow path ends at a variant with an assigned landing page

Invalid Segment Rules

A segment node has incomplete or invalid targeting rules.

Solution:

1. Click the segment node showing a warning indicator

2. Review the configuration panel that opens on the right

3. Check each rule for completeness:

   • Ensure operators have comparison values (e.g., "equals" requires a value to compare against)
   • Verify all required fields are populated
   • Confirm rule syntax is correct

4. Common rule fixes:

   • UTM parameters: Verify exact spelling matches your actual UTM values (case-sensitive)
   • Device targeting: Select at least one device type (desktop, mobile, or tablet)
   • Geographic targeting: Choose valid countries or regions from the dropdown

Variant Without Landing Page

A variant node doesn't have a landing page assigned.

Solution:

1. Click the variant node showing the error
2. In the configuration panel, click Select Landing Page to choose an existing page
3. Alternatively, click Create Landing Page to generate a new one with AI
4. Verify the landing page status is Published and not still processing
5. Repeat for all variant nodes in your flow

Circular Path Detected

Your flow contains a loop that would cause infinite redirects for visitors.

Solution:

1. Review your flow structure carefully
2. Look for connections that circle back to previous nodes
3. Trace each path to ensure visitors flow in one direction only
4. Identify the connection creating the loop
5. Click the problematic connection line and press Delete, or right-click and select Delete
6. Redesign the flow to be linear or branching (never circular)

A/B Test Configuration Invalid

An A/B test node has problems with variant distribution settings.

Solution:

1. Click the A/B test node showing the error

2. Verify all variants have assigned weights:

   • Weights must be positive numbers
   • Zero weight means no traffic to that variant
   • Weights are relative, not absolute (30/70 equals 3/7)

3. Ensure at least 2 variants exist:

   • A/B tests require minimum two variants
   • Add more variants with Add Variant
   • Or convert to a simple variant node if testing isn't needed

4. Verify each variant has a unique name or identifier

5. Confirm all variants have landing pages assigned

Flow Best Practices

• Keep flows simple and linear when possible
• Use segment nodes to split traffic based on targeting rules
• Use A/B test nodes to compare landing page performance
• Always end paths with a variant that has a landing page
• Test in preview mode before publishing to production

FAQ

Related Resources

• Campaign Flow Guide
• Segments and Targeting
• A/B Testing