Set up Conditional Fields

People don't like filling out long forms. By only asking relevant questions, you can create the illusion that your form is short. With Conditional Fields, you can easily create smart and dynamic Joomla forms that react to your users' actions.

With Convert Forms Conditional Fields, you can create rules to:

Show and hide fields

Change values in fields

Add and remove items to/from a list

TABLE OF CONTENT

• How to use the Conditional Fields Builder
• How Conditional Logic Rules are Processed
• Basic Conditional Logic
• Complex Conditional Logic
• Behavior of Conditional Logic
• Tips for using Conditional Logic
• Frequently Asked Questions

How to use the Conditional Fields Builder

In this guide, you will learn how conditional logic for fields works and how to utilize it to create dynamic fields and personalized forms.

Convert Forms manages conditional fields centrally, under the Behavior tab in the left settings panel. You must enable the Conditional Logic option first and then click Setup Conditions to open the simple yet powerful condition builder environment.

Once the builder opens up for the first time, you will be greeted with a message that says, “You haven't added any conditions to this form yet”. Click ‘Add Condition’ to add your first condition to the form.

After at least one condition is configured, you should be able to see more options. The builder is divided into two parts: the Conditions List and the Condition Settings.

The left sidebar shows all the form conditions you've created at a glance. Think of it as a menu that helps you easily navigate through each condition's settings.

When you click on an item on the list, the respective condition settings appear at the right. This is helpful, especially with complex forms where you must focus on one condition at a time.

Each item on the list can have a unique label so you can easily distinguish each condition. Just click on an item, and its label will be turned into editable input. You can write anything you want, as the label appears only in the backend.

Additionally, when you hover over an item, a toolbar with two buttons appears that helps you delete and copy a condition.

To add a condition, you click on the Add Condition button. Although there's no limit on how many conditions a form can have, it is recommended to keep it to the minimum for performance reasons, especially if your form consists of many fields. Read Does conditional logic impact performance? FAQ to learn more. Lastly, conditions are independent and do not interact with one another.

The magic happens in the right area of the builder. There, you can set up each condition's rules and actions. A condition is organized into the following three sections.

1. When (Rules)

These are the rules that need to be met to execute actions. A rule is always based on the value of a field and consists of three options: the Source Field, the Comparison Operator, and the Source Value.

To better understand what each option does, let's see an example of a dead-simple condition in plain English.

WHEN FIELD1 equals to 123 SHOW FIELD2

The FIELD1 equals to 123 part is our rule. Where FIELD1 is the Source Field, equals to is the Comparison Operator, and 123 represents the Source Value.

Source Field

The field of the form that accepts the user input will affect the fields in which we want to behave dynamically. Fields that do not require user input, such as HTML and Submit Button, won't be included.

Comparison Operator

Configure how to compare the expected value set in the Source Value with the user input. The options shown in this dropdown may vary depending on the type of the selected Source Field. For instance, the Has Selected option will appear in the list only if the selected Source Field is a Dropdown or Checkbox field.

Here’s a list of all supported operators.

Source Value

The expected value of the Source Field will make the rule valid. The display of this option varies depending on the type of the selected Source Field and the selected Comparison Operator. For example, if the selected Source Field is a type of Radio Buttons and the Operator is set to Equals, you should see a dropdown populated with the field's choices while with the Operator set to Starts With, the Source Value will be turned into a free text waiting for a custom value.

Read How Conditional Logic Rules are Processed to learn more technical details about how rules are evaluated and processed

2. Do (Actions)

This is where you configure what actions to execute when the condition is met, like showing or hiding a field or changing its value. An action consists of two options: the Field and the Action options.

Target Field

This represents the field of the form to execute the action if the condition is satisfied. Since configuring conditional logic for a field based on its values is not supported, you cannot select a field used in the Rules section.

Action

In this option, you select from a predefined list of actions how the selected field will be affected. The options in the dropdown will vary depending on the chosen field type. For instance, if the selected field is a type of Dropdown, you should see actions that run on options such as Show Option and Hide Option.

Value

This option is only available when the Action is set to Change Value, and it represents the value we'd like the field to get when the action is executed.

Here’s a list of all supported actions.

3. If the condition is not met

Lastly, you can optionally define what to do when the rules defined in the When section are unmet. This is rather useful for two reasons. First, it ensures your conditional fields have a default state when the form appears initially on the page load. Second, it saves you time, as you don’t need to create a separate condition for the actions that need to run when the condition is not met.

How Conditional Logic Rules are Processed

Rules are organized into sets of rules called groups. Rules inside a group are evaluated using the AND operator, while Rule Groups are evaluated using the OR operator. That means a condition is met when all rules inside at least one group are valid.

When a group is found to be valid, the processing or rules stop to prevent unnecessary workload on the browser, as the condition has already been met.

Both rules and rule groups are processed from top to bottom as configured in the backend.

Basic Conditional Logic

The most common use of conditional logic is to show or hide fields based on a user’s selection. Let's look at an example.

Suppose you have a dropdown called “Business Type” with 3 options: Retail, Food Service, or Other. You also have a textfield called “Other Business Type” which you would like to show only when the “Other” option is selected in the Business Type dropdown.

Here's how our conditional logic rule formula would be in plain English:

WHEN BUSINESS TYPE EQUALS TO OTHER SHOW OTHER BUSINESS TYPE

Let's see how we can implement that formula using Convert Forms Conditional Fields.

Start by opening the form builder. Go to Behavior -> Conditional Fields, and click Setup Conditions. On the open window, click Add Condition to add your first condition.

For this scenario, we will need a condition with a single rule. In the When section, in the first dropdown, select Business Type as our Source Field, set the Operator to Equals, and in the 3rd dropdown, choose Other.

Next, we must define the action to execute when the rule is met. In our case, we want the field Other Business Type to appear. To do so, in the “Do” section, in the first dropdown, select Other Business Type and set the Action option to Show Field.

Lastly, we want the same field to disappear when the user doesn’t select the Other option in the Business Type field. In the "If the condition is not met" section, click on the button with the plus icon to add an action, select the Other Business Type field from the 1st dropdown, and set the Action to Hide Field.

Click Save, and you're done. You have now applied conditional logic to your form!

Complex Conditional Logic

You may find that a single conditional logic rule isn’t complex enough for some situations. However, you can add as many conditions as you’d like.

For example, we’ll ask users to subscribe to our retail marketing newsletter. However, we only want to display the submit button if they’ve shared an email address and accepted our terms and conditions.

To set this up, we must add an Email Address field and a Terms of Service field to our form.

Next, we’ll repeat the process from the previous section to enable conditional logic and add our rules. This time, we are going to use 2 rules which will state:

WHEN EMAIL ADDRESS IS NOT EMPTY AND TERMS OF SERVICE IS CHECKED SHOW SUBMIT

Go to Behavior -> Conditional Logic, open the conditional logic builder, and click Add Condition to a new condition.

The first rule concerns the Email field, which is required not to be empty. Select Email Address in the fields dropdown, and set the Comparison Operator to Is not empty. Next, click on the first button with the plus icon to add a second rule. From the fields dropdown, select Terms of Service and set the Operator to Is checked.

Our rules should look like in the screenshot below:

Next, we'll need to set the actions for our condition to show the submit button when it is met and hide it when it is not met. Therefore, our actions should look like in the screenshot below:

Click save, and you’re done. You have now applied a more complex conditional logic to your form.

Behavior of Conditional Logic

Keep the following behavior in mind as you work with conditional logic in your forms:

• Target fields will be only included in the submission data if they are displayed when the form is submitted.
• Target fields are only required if they are displayed when the form is submitted.
• Editing the Values of list-based fields such as Dropdown, Radio Buttons, and Checkboxes used in your conditional logic may affect existing rules.
• If you remove a field from the form, associated conditional logic may also be removed.
• When more than one logic rule affects a target field, the field will be shown when any rules are satisfied.

Tips for using Conditional Logic

Use these tips to create more versatile rules with conditional logic:

Choose an appropriate operator

If you want to display a target field in more cases than not, listing all of those cases can be inefficient. Instead, accomplish the same result with a shorter condition than using inverse operators such as Does not equal. For instance, if you want to display the Submit button in all cases except when value "A" is selected in a dropdown field, you can use the following rule:

Nested Logic

A target field can also be a source field, allowing you to create nested logic. For example, the answer to Question 1 can cause the form to display Question 2, and the answer to Question 2 can cause the form to display Question 3. If the answer to Question 1 changes such that Question 2 is not shown, then Question 3 will not be displayed either.

Frequently Asked Questions

Can I integrate conditional logic with Email Notifications?

To send emails conditionally, use the Email app in the Tasks section.

Can I sync submissions with 3rd party apps like MailChimp or GetResponse conditionally?

Yes, use the Tasks section. 

How do I display a different success message based on a field value?

To do so, you must use PHP in the PHP Scripts -> After Form Submission area. To learn how to do that, visit the respective section on the PHP Scripts doc page.

Can I create calculations based on field values?

You don't need conditional logic to create calculations based on field values. You need to enable the Calculations option found in the field settings. To learn more details, visit the Calculations guide. Additionally, after you’ve set up your calculations, you can set up conditional logic based on the calculated values.

Can I create a rule based on the length of a field value?

Not yet. This feature is on the to-do list. When implemented, you can show or hide a field based on its value. For example, if “FIELD A” is shorter than 7 characters, show “FIELD B.”

Can I create conditional logic with dates?

Not yet. This is on the to-do list as well.

Can I create conditional logic with File Upload fields?

Not yet. This is on the to-do list as well.

Is there any limitation on the number of conditions a form can have?

No, there’s no limit on the number of conditions or rules you can have on a form. However, it is recommended to keep it to the minimum for browser performance reasons.

Does conditional logic impact performance?