Core Docs - Core Concepts - Add Form Fields

Rock Version: v20.0
Last Modified: 2026-07-13 2:31 PM

Now that you're familiar with the different parts of the form you're ready to start adding fields. Fields are pieces of input that the person filling out the form is asked to provide. Fields are added to the form by clicking them from the left of the page and dragging them into a section on the right. For instance, you might add a Boolean field if you want the person to answer a simple Yes/No question. You might add a Text or Memo field if you want the person to provide a typed answer to a question. There are many field options for gathering different types of data from the person. Let's look at adding some fields to a form.

Adjusting Field Settings

There are many types of fields you can add to your form, and each of them has unique settings that are specific to the field. For instance, if you use a Single-Select then you'll need to provide a list of values that the person can choose from. We won't cover every possible field and its configuration in this document, but there are elements that all fields on your form share.

Name - The Name of the field appears on the form and is visible to the person. More often than not you'll want to change the name of the field to make it relevant to what you're asking the person for.  

Description - If you add a Description, it will create a tooltip icon (ti ti-info-circle) next to the field name. The person filling out the form can hover their mouse over the icon to see the description you've added. This is a great way to provide instructions or clarification for the person filling out the form.  

Unique Properties - This area will change depending on the field. Some fields have multiple configurable properties, while others will simply have an optional Default Value.  

Conditionals - You can add logic to the field so that it is shown or hidden depending on the person's answers to other questions on the form. For instance, you might only want to show a Baptism Date field if the person indicates they have been baptized.  

Format - The Column Span setting lets you control the width of the field on the form. Reducing the width of multiple fields lets you display those fields horizontally rather than vertically. You might also use this so that narrow fields (like Date or Integer) don't take up the full width of the form. Here you can also indicate whether the field should be Required, and you can choose to hide the field's label (i.e., Name).  

Advanced - If needed, you can adjust the field's Key value. This can be important when you're using the field in other workflow actions. Here you can also choose to Show on Results Grid, which will display the value of the field in the Workflow List when viewing submissions.  

Let's pause for a moment to talk a little bit more about the Column Span setting referenced above. The width of your form is broken up into 12 equal sized columns. So, adding a field that is 12 columns wide means that the field will be the full width of the form. If you want multiple fields on the same line/row, you can reduce the widths of the fields. For instance, a field that is six columns wide can be on the same line as another field that is six columns wide. In that case both fields would be half the width of the form. Or you could have four fields that are each three columns wide, allowing all four fields to be on the same line. The key is remembering you have 12 columns total to work with.