Forms

Collect data from your users with forms that add new records to your tables

Each View comes with a form that you can use to create a new record that will be added to that table.

Each form can be customized by

Changing the form header

By turning on Build Mode you can customize the form's header and subtitle in the Header section of the editor sidebar. The Subtitle section supports Markdown to allow you to style your content as you like it

Customize the form Fields

By turning on Build Mode you can customize the form's fields by turning on or off any of the fields. Noloco automatically shows you the fields in your table.

You can customize each field by hovering over the field and clicking the Edit icon. This will open the field's configuration editor where you can change things like the label, the help text, the default value, the field's display type (if any) and any validation rules or conditional visibility rules.

Adding a section to your form

You can add sections to your form to logically group parts of your form. Each section supports it's own title and subtitle which can provide context to the section, but sections can also have their own conditional visibility rules, allowing you to quickly show or hide all fields in the section

Read more about conditional visibility

Field Validation Rules

Validation rules are a great way to ensure that your form fields contain the right data before they're saved. This means you can guarantee the integrity of your data, and help your team avoid making mistakes.

You can add validation rules to any field, the rules available will depend on the field type, for example:

  • Text Fields:

    • Text length: specify the length must be less than, greater than or equal to a value

    • Text value: specify the text value must equal to, contain or not equals a value

    • URL: the value must be a url or domain name

    • Email: the value must be a valid email

    • IP address: the value must be an IP address

    • Pattern match: the value must match a regex pattern

  • Number fields

    • The value must be less than, greater than or equal to a value

  • Date fields

    • The value must be less than, greater than or equal to a static or dynamic date

There are more field types with their own custom rule types

Field Visibility

To customize the flow of your form you can specify field visibility rules on each field.

For example, you might want to hide the Notes field if the customer's status is Inactive to make the form experience easier on your team or clients.

Form Field visibility is fully explained here

Troubleshooting Form Issues

Missing Form Field Text Boxes

If text input boxes are missing from your form fields:

  1. Check Field Configuration: Ensure the field is enabled in form settings

    • Go to build mode on the form page

    • Verify the field is toggled ON in the form field list

    • Check if the field has proper display settings configured

  2. Verify Field Permissions: Confirm users have permission to access the field

    • Check table-level permissions for the user's role

    • Ensure the field has CREATE permission for form submissions

    • Verify READ permission if the field shows existing data

  3. Review Field Visibility Rules: Check if conditional visibility is hiding the field

    • Review any conditional visibility rules on the field

    • Ensure visibility conditions are met for the current user/context

    • Test with different user roles using "View as user"

  4. Field Type Issues: Some field types may not display as expected

    • Verify the field type is supported for form input

    • Check if custom display settings are configured correctly

    • Try switching field display type temporarily to test

User Permission Issues with Form Fields

When forms work for admins but not for regular users:

  1. Check User Role Permissions: Verify the user's role has proper table access

    • Go to Data & API tab > hover over table > Permissions

    • Ensure the user's role has CREATE permission for new records

    • Check UPDATE permission if editing existing records

  2. Field-Level Permissions: Review specific field permissions

    • Check if specific fields (like "NEW EMAIL") have restricted access

    • Ensure the user's role can CREATE/UPDATE the problematic fields

    • Look for field-level permission rules that might exclude certain roles

  3. Test User Context: Use the "View as user" feature to debug

    • Switch to the affected user's role in build mode

    • Try submitting the form from their perspective

    • Check what error messages or behaviors occur

  4. Review Recent Changes: If it worked before but stopped

    • Check recent permission rule changes

    • Verify app republishing status

    • Review any user role modifications

Form Submission Issues

When forms don't submit properly despite no visible errors:

  1. Check Required Fields: Ensure all required fields are completed

    • Review which fields are marked as required

    • Test with minimal data to isolate problematic fields

    • Check for hidden required fields that users can't see

  2. Validation Rule Issues: Review form validation rules

    • Check if validation rules are preventing submission

    • Look for custom validation that might be too restrictive

    • Test removing validation rules temporarily

  3. File Upload Problems: For forms with file uploads

    • Verify file size limits aren't exceeded

    • Check file type restrictions

    • Ensure file upload fields have proper permissions

  4. Javascript/Browser Issues: Test in different environments

    • Try submitting in incognito mode

    • Test in different browsers

    • Check browser console for Javascript errors

  5. Data Relationship Issues: For forms with linked fields

    • Ensure linked records exist and are accessible

    • Check if required linked fields are properly populated

    • Verify relationship field permissions

Form Validation Not Working

If validation rules aren't behaving as expected:

  1. Rule Configuration: Verify validation rules are properly set up

    • Check the validation rule syntax

    • Ensure the rule type matches the field type

    • Test with simple validation rules first

  2. Field Value Issues: Check if field values meet validation criteria

    • For number fields, ensure values don't exceed JavaScript limits (9,007,199,254,740,991)

    • For text fields, check length restrictions

    • For date fields, verify date format compatibility

  3. Conditional Validation: For complex validation scenarios

    • Test validation rules independently

    • Check if conditional logic is working correctly

    • Simplify rules to isolate issues

General Form Troubleshooting Tips

  1. Test Systematically: Isolate issues by testing one component at a time

  2. Use Incognito Mode: Test forms in incognito browsers to avoid cache issues

  3. Check Console Errors: Look for JavaScript errors in browser developer tools

  4. Verify Publishing: Ensure app is published after making form changes

  5. Test Different User Roles: Use "View as user" to test various permission scenarios

  6. Start Simple: Begin with basic form configuration and add complexity gradually

When to Contact Support

Contact support if you experience:

  • Forms that worked previously but suddenly stopped

  • Validation rules that don't save or apply correctly

  • Persistent permission issues after following troubleshooting steps

  • Browser-specific form submission problems

  • File upload errors that persist across different file types and sizes

Last updated

Was this helpful?