Forms Troubleshooting

Forms Troubleshooting

Form Not Loading

Check 1: API Running

curl http://localhost:3000/api/health

Check 2: Permissions

• You must be a member of the organization that owns the form
• Form must be published (not draft)

Check 3: Browser Console

Open Developer Tools (F12) → Console tab and look for errors.

Dropdown Empty

If a dropdown field shows no options:

Check Data Provider Exists

The data provider referenced by the field must exist and return data.

Check Data Provider Format

from bifrost import data_provider

# ✅ Correct format
@data_provider(name="get_options", description="Get options")
async def get_options():
    return [
        {"label": "Option 1", "value": "opt1"},
        {"label": "Option 2", "value": "opt2"}
    ]

# ❌ Wrong format
@data_provider(name="get_options", description="Get options")
async def get_options():
    return ["Option 1", "Option 2"]  # Missing label/value

Form Submission Fails

Check 1: Required Fields

All fields marked with red asterisk (*) must have values.

Check 2: Validation

Field values must pass validation rules (e.g., valid email format).

Check 3: Workflow Exists

The workflow the form executes must exist and be discoverable.

Field Not Appearing

Check Visibility Rules

Fields can be hidden based on conditions:

• Other field values
• User permissions
• Organization settings

Check the field’s visibility rules in the form builder.

See Also

• Creating Forms
• Visibility Rules
• Data Providers