Conditional Field

The Conditional Macro allows you to display or hide form fields based on specific conditions. This is helpful for making your forms dynamic, showing only relevant fields depending on previous user input.

How to Add a FreshForms Conditional Field#

1. Edit the page where you want to add the form.
2. Click the “Insert More Content” button (usually represented by a “+” icon).
3. From the dropdown, select Other Macros.
4. Then type FreshForms- scroll and select FreshForms Checkbox.

This will insert a FreshForms Conditional Field within the Container Macro.

Configuration Options#

Field Name#

Required. The name of the field being observed for the condition. Make sure the field name is entered exactly as it appears in your form.

Example: employmentStatus, age, feedbackType

Condition Types#

1. Has No Value#

This condition checks whether the field is empty or has no value. If the field is not filled out or left blank, the content inside the Conditional Macro will be displayed.

Example:

• Field Name: phoneNumber
• Condition: “Has No Value”

If the user hasn’t entered a phone number (the field is left blank), the fields inside the conditional body (e.g., “Please enter your phone number”) will appear. If the phone number is filled out, the content will remain hidden.

Example Usage:

• Show a reminder to enter a phone number if it hasn’t been filled out.

2. Has Specific Value#

This condition checks whether the field contains a specific value that you define. If the field value exactly matches the condition, the content inside the Conditional Macro will be shown.

Example:

• Field Name: employmentStatus
• Condition: “Has Specific Value” — “full-time”

If the user selects “full-time” for the employmentStatus field, the fields inside the conditional body (e.g., “Upload Resume”) will appear. If the value is anything other than “full-time,” the field will remain hidden.

Example Usage:

• Show the “Upload Resume” field if “employmentStatus” equals “full-time.”

3. Has Any Value#

This condition checks whether the field has any value entered at all. If the field contains any value (even a single character), the content inside the Conditional Macro will become visible.

Example:

• Field Name: comments
• Condition: “Has Any Value”

If the user types anything in the comments field, the content inside the macro (e.g., “Thank you for your feedback!”) will appear. If the field is left blank, the content will remain hidden.

Example Usage:

• Show a confirmation message after a user provides comments.

Visibility Control#

The content inside the conditional macro will either be visible or hidden depending on whether the condition is met. You can combine these conditions to create more dynamic and interactive forms.