UI Bakery Docs
RoadmapRelease notesSign In
  • 👋Welcome to UI Bakery!
  • 🌟Overview
    • 💡Video intro
    • ✨Main features
    • 🔖Glossary
  • 🛠️Getting started
    • Create an application
    • Build UI
      • Data mocking methods
    • Link components
    • Connect a data source
    • Load data
    • Bind data to UI
    • Transform data with JavaScript
      • Data mapping & transforming
    • Change component data
    • Send a form
    • Create a filter
    • Note on debugging
    • Deploy your application & invite users
  • 📌Concepts
    • Components
      • Component basics
      • Component methods
      • Components best practices
        • Input validation
        • Linking a Table to a Form/Detail
        • Using a single Form to add and update data
        • Searching Table based on input value
        • Configuring server-side pagination
        • Managing Date object time zones
        • Role-based Menu component items
        • Field types & types recognition
        • Expanding component to fit screen/container
        • Controlling component's visibility
    • Custom components
      • Unrestricted custom components
    • Data sources
      • Data source environments
      • Connecting local database via ngrok
      • SSH Tunneling
    • Actions
      • Actions basics
        • Calling actions from code
      • Actions management & shortcuts
      • Actions settings
      • Actions library
      • Server actions
      • Logs and debugging
    • UI Bakery variables
    • State variables
    • Local storage
    • Modules
    • Custom JavaScript
      • JavaScript files
    • Workspace management
      • Account & workspace
      • Seats & Shared permission groups in UI Bakery
      • Roles in UI Bakery
      • Role permissions
      • Explore the interface
      • App environments
        • Release management
      • Audit logs
      • Multi-factor authentication
    • Export & import an app
    • Mobile layout
    • Theme editor
      • Changing theme from the app
    • UI Bakery source control
      • Git controls overview
      • Migrating your app model to the latest version
  • ⚡How-tos
    • File management
      • Working with PDF files
      • CSV import & export
      • Uploading files using methods
      • Displaying files from Google Drive and Dropbox
      • Parsing and sending XML
    • Styling
      • Modifying components with CSS
    • Layout & navigation
      • Adding navigation to application
      • Reading query params from URL
      • Hiding UI Bakery loader in the Embedded mode
    • Data
      • Managing user data with the {{user.email}} variable
      • Using JS libraries
        • Internationalization (i18n) & Localization: Translating UI Bakery Apps
      • Implementing row-level security
      • Copying to clipboard
    • Custom code
      • Communicating with external sites via Iframe
      • Implementing custom app hotkeys
      • Retrying API with HTTP status code 202
  • 🔎Extras
    • UI Bakery Automations
      • Environment and release strategy
      • Git in automations
      • Using external Node libraries
    • UI Bakery Database
      • Database migration
  • 💻On-premise
    • UI Bakery on-premise
    • Install & update
      • Installing on-premise
        • Azure virtual machine
        • Azure container instance
        • AWS EC2 instance
        • Google Cloud Compute Engine VM instance
        • DigitalOcean 1-click droplet
        • Manual w/ docker compose
        • Manual w/ docker run
        • Windows installation
        • Kubernetes
          • AWS EKS with Fargate
          • Scaling and resource optimization
      • Troubleshooting installation errors
      • Updating on-premise
      • Updating license key
      • Updating environment variables
      • Recommendations
        • Architecture overview
        • UI Bakery in production
        • Resource optimization
        • Running a standalone database instance
        • Generating custom secrets
    • On-premise features
      • External analytics
      • Branding
      • Embedding
      • SCIM 2.0
      • Instance API
      • Activating features under a feature flag
    • Additional configurations
      • Health check API
      • Email configuration
      • Google Sheets connection setup
      • Salesforce connection setup
      • Azure blob storage configuration
      • Adding python backend code to existing installation
      • UI Bakery Postgres
    • Networking & security
      • Setting up a domain name
      • Configuring custom certificate authority
      • Custom base URL
      • Getting requests to the local network
      • Setting up SSL on Ubuntu
    • SSO
      • OpenID
        • Google OAuth2
        • Okta ODIC
        • Azure AD OAuth2
        • Token refresh
      • SAML
        • Okta SAML
        • Azure AD SAML
      • Role synchronization
      • Multiple SSO
      • Logout redirect
      • Troubleshooting
    • Git source control
      • Manage multi-instance deployment
      • Custom PR URL
      • Automate GitHub releases
      • Automate GitLab releases
      • Automate Bitbucket releases
    • Environment variables
  • 📚Reference
    • Data security measures
    • Improving app security
    • ✨AI Assistant
    • List of Components
      • S3 file uploader
      • Azure Blob Storage file uploader
      • Accordion
      • Alert
      • Avatar
      • Boolean
      • Breadcrumbs
      • Bubble map
      • Button
      • Card
      • Chart
      • Chat
      • Checkbox
      • Collapsible card
      • Color picker
      • Composite form
      • Container
      • Context menu button
      • Currency
      • Currency input
      • Date picker
      • Date & time
      • Date & time picker
      • Detail
      • Divider
      • Email input
      • Embedded App
      • File
      • File dropzone
      • File picker
      • Flex container
      • Form
      • Frame drawer
      • Grid view
      • Heading
      • Horizontal menu
      • Icon
      • iFrame
      • Image
      • Image picker
      • JSON editor
      • JSON viewer
      • Link
      • List view
      • Map
      • Menu
      • Metric
      • Modal
      • Multi-select
      • Number
      • Number input
      • Password input
      • PDF viewer
      • Percent
      • Pop-up form
      • Progress bar
      • QR code
      • Radio
      • Range slider
      • Rating
      • Reusable header
      • Reusable sidebar
      • Select
      • Signature
      • Slider
      • Steps
      • Stepper
      • Table
        • Conditional formatting based on cell value
        • Display name instead of ID for relation
        • Row context referencing
        • Select multiple table rows
        • How to Highlight Text in a Table Using mark.js
      • Tabs
      • Tabset
      • Tags
      • Text
      • Text annotate
      • Text input
      • Time picker
      • Toggle
      • Tree component
      • Video
      • Dynamic structure properties
      • Card (deprecated)
      • Input (deprecated)
    • Upgrading components
    • List of Data sources
      • Airtable
      • AWS S3
        • S3 compatible endpoints (DigitalOcean spaces)
      • AWS API
      • AWS Athena
      • AWS DynamoDB
      • AWS Lambda
      • AWS Redshift
      • Azure Blob Storage
      • Big Query
      • Databricks
      • Exasol
      • Firestore, Firebase Auth & Realtime DB
        • Firebase authentication
        • Managing database data
        • Firebase client-side SDK
        • Firebase libraries
      • GitHub
      • Google Sheets
      • GraphQL
      • HTTP API
        • API Authentication
      • HubSpot
      • Twilio
      • JDBC
      • MariaDB
      • MongoDB
      • MySQL
      • OpenAI
      • OpenAPI
      • Oracle
      • PostgreSQL
      • Presto
      • Redis
      • Salesforce
      • SAP Hana
      • SMTP
      • SendGrid
      • Slack
      • Snowflake
      • Spanner
      • SSH
      • Stripe
      • SQL Server
      • Supabase
      • UI Bakery AI
    • List of Action steps
      • Azure Blob Storage query
      • Bulk Create Rows
      • Bulk Delete Rows
      • Code step
      • Condition step
      • Create Row
      • Delete Row
      • DynamoDB request
      • Execute another action
      • Firebase query
      • Generate file
      • GraphQL query
      • HTTP request
      • Interval step
      • Load Table
      • Load Row
      • Loop action
      • MongoDB command
      • Navigation action
      • Open API request
      • Python backend code
      • Redis command
      • S3 query
      • Save to local storage
      • Save to state
      • Show notification
      • Slack messages
      • SMTP request
      • SSH command
      • SQL query
        • Writing SQL Queries
      • Update Row
    • Troubleshooting techniques
    • Performance optimization
Powered by GitBook

© 2025 UI Bakery

On this page
  • Default validators
  • Form/Detail validators
  • Custom validators
  • To create a custom validator:
  • Async validators
  • Custom validators for a Form component

Was this helpful?

Export as PDF
  1. Concepts
  2. Components
  3. Components best practices

Input validation

PreviousComponents best practicesNextLinking a Table to a Form/Detail

Last updated 1 month ago

Was this helpful?

UI Bakery offers various methods of validating user input. You can use our built-in validators or create custom ones. In this article, we'll explore them in more details.

Here, we talk about , , , and components.

Default validators

UI Bakery features a range of built-in validators for different inputs, such as Min/Max, Required, Regexp, etc. Validation occurs once a user inputs a value. By default, errors are shown after the input loses focus. But you can change this by clearing the Show error after touched checkbox, and then errors will be shown immediately.

You can also create logic based on validation status. For this purpose, you can use the {{ui.input.valid}} variable that holds a Boolean value indicating the input's validity.

Form/Detail validators

You can configure default validators for Form/Detail components' fields. To do so, follow the instruction below:

  1. Select your component and click on the field you want to add validation to.

  2. Expand the Edit settings section and scroll to the list of validators.

  3. Set the Min setting value as 100, for example, and then input a value less than 100 in the Id field. The Form component will react to the input validation, showing an error.

You can adjust this behavior by selecting the Disable submit when invalid checkbox which disables submission altogether if the input value is invalid.

Custom validators

Besides using built-in validators, UI Bakery also allows creating custom validators. They are executed when the input changes, displaying an error next to the input.

Custom validators work according to the following rules:

  • When the input's value changes, the validator is executed

  • The {{params}} variable holds the current input value, enabling the creation of validation conditions

  • If the validator returns a String or an array of Strings, these will be displayed as errors

  • If the validator returns null or an empty value, validation is considered successful - no errors are shown, and the input is deemed valid

  • During validation the input is considered invalid

  • Validation is complete once all assigned validators have been executed

If the input value is empty, the validator will display the following error:

return {{params}} ? null : 'Field is required';

Custom validators can be assigned to different components. Check out the instruction below to learn how to create and assign a custom validator to a Text input component. The same way, you can do it for other components as well.

To create a custom validator:

  1. Select the Text input component and navigate to the Validation section.

  2. In the Custom validators dropdown, click Create action.

  3. Select a JavaScript Code action type and specify the following code to modify the validator condition:

return {{params}} ? null : 'Field is required';
  1. Also, you can add a Text component and specify for it the following variables to check input status programmatically:

    1. {{ui.input.valid}} - indicates whether an input is valid

    2. {{ui.input.validating}} - indicates if a validator is currently running

Async validators

Custom validators can also execute asynchronous validation operations, for example, making an API request to check if an email address is available. Let's review this example in the instruction below.

To create an async validator:

  1. Select the Text input component and navigate to the Validation section.

  2. In the Custom validators dropdown, click Create action.

  3. For the first step, add an HTTP Request action type to verify if a user with the provided email address exists:

https://example-data.draftbit.com/users?email={{params}}

  1. And for the second step, add a JavaScript Code action type.

  2. Specify the following condition to verify the presence of a user from the API response:

return {{data.length > 0}} ? 'Email is already taken' : null;

If the user list is not empty, the error message that you specified will be displayed.

Custom validators for a Form component

You can also assign custom validators to a Form component. These validators receive the entire form object as {{params}} input and must return an object where each key is an input name and each value is an error message. This allows the form validator to assign errors to multiple fields in a single run.

To do so, you simply need to create a JavaScript Code action with the code below and assign it as a custom validator for the component:

return {{params.id}} ? null : { id: 'Field is required', name: 'Field is required' };

Setting errors manually with setErrors

You can also set errors manually for a Form. For example, in some cases, the form should be submitted, but based on the API's error response, it should either succeed or display errors.

For this purpose, you can use the {{ui.form.setErrors()}} method to set errors accordingly.

Global error for Form/Detail components

Form and Detail components can also display a global error message if an error occurs during the On Submit action. Follow the instruction below to enable this functionality:

  1. Select your Form component and navigate to the Appearance section.

  2. Here, select the Show error message checkbox and add your error message (for example, 'Id field is not valid').

  3. Next, assign a new action for the On Submit trigger.

  4. Select a JavaScript Code action type and specify the following logic to throw a JS error:

if ({{ui.form.value.id}} < 100) {
  throw new Error();
}
  1. Next, click the Submit button to submit the form.

📌
Text
Text input
Form
Detail