Common Issues

Form not saving

Possible causes and solutions:

1. Check your internet connection — the builder requires a live connection to save.
2. Check for duplicate field names — two or more fields with the same name will block saving. Open JSON mode to identify and resolve conflicts.
3. Check for empty required field properties — fields with a type but no label or name are invalid.
4. Try refreshing the browser and re-opening the form. Browser-side auto-save should restore recent changes.

Validation not triggering

If required fields are not showing errors when left blank:

• Confirm the field has `required: true` in its settings.
• Check if the field has conditional logic that is hiding it — hidden fields bypass validation.
• Ensure you are clicking Submit and not a custom button with a different action.

Conditional logic not working

If a field is not showing or hiding as expected:

1. Verify the referenced field name in the condition matches exactly (case-sensitive).
2. Check the operator — "equals" requires an exact match. For partial matches use "contains".
3. Ensure the condition value matches the field's stored value, not its display label (for select fields, use the option's value, not its label).
4. Open the browser console (F12) to see if any JavaScript errors are present.

Form submission fails

If clicking Submit shows an error or nothing happens:

• Check that the form is published (draft forms cannot receive submissions from public URLs).
• Verify all required fields have values.
• Check the browser console for network errors — a 4xx/5xx response indicates a server-side problem.
• If using a webhook, ensure the webhook URL is reachable and returns a 2xx response.

File upload issues

• Ensure the file type is allowed by the field's `accept` configuration.
• Check that the file size is below the `maxFileSize` limit.
• Some corporate networks block file uploads — ask your IT team about proxy or firewall rules.