Add Ratings Block to Clappia App

This article explains the features of the Ratings block and how it can be used to design your app.

Use Cases

1. Selecting ant one option from a pre-defined set of values.
2. Making specific blocks appear as the user selects an option.

Editing the Block

Click on the block and configure it by editing on the right panel.

‍

Label

The label is the name of the block that the end user sees in the app.

Example: Cleanliness in the site during survey. 

‍

Description

The description is the additional information provided to the end user which will be displayed below the input area.

Example: 1 being the least and 5 being the highest. 

‍

This is how the Ratings block with the label and the description will look to the end user.

‍

‍

‍

‍

‍

‍

Select emojis and their corresponding values

Select Emojis and a unique score for each Emoji. You can add up to 10 distinct values. The value can be any number, positive, negative, or zero.

Below are some commonly used sets of Emojis.

‍

‍

‍

‍

‍

‍

‍

‍

‍

‍

Show not applicable option

This can be used where none of the scores are relevant for a use case. You can customize the text that appears along with the Not Applicable checkbox and the value associated with this option.

‍

Choose size of Emojis

Use this option to resize the Emojis. You can use a larger size if you have few scores and a smaller size if you have too many scores.

‍

‍

‍

‍

‍

Advanced Options

Use this option to show the advanced options to configure the Ratings block.

‍

Display this field if

Use this if you want to show or hide a field under certain conditions. It accepts the standard Clappia Formulae, similar to conditional sections.

1. You can type ‘@’ to get a list of all the variables in the app and select variables.
2. Using these variables you can write Excel-like formulae.

‍

Example: When the end user inputs the Survey Site Name name, you can show the Cleanliness in the site during survey block.

‍

Allow value to be changed after initial submission

This option is enabled by default. End users can edit and change the selected option after creating a submission. Disable it if you do not want the end users to change the selected option.

‍

Advanced Label

The Advanced Label option allows you to change the label of a field dynamically based on a condition you define. Instead of always showing the same fixed label under the ‘Basic’ tab, the field can display different labels depending on requirements of the form. Use spreadsheet-like functions such as IF, AND, OR, etc. and make use of other field variables to set your conditions. Type @ and select the field.

This is useful when the meaning of a field changes based on context, business logic, or user choices.

For example:
If you have a dropdown named Feedback Type with options “Service Feedback” and “Product Feedback”.
Your Ratings block should show the label that fits the context.

So:
– If Service Feedback, show “Rate Our Service”
– If Product Feedback, show “Rate Our Product”

Formula:

This allows the same field to adapt its displayed purpose without needing multiple separate fields.

‍

Advanced Description

The Advanced Description option works exactly like Advanced Label, but it changes the description text instead. This is useful when guidance or instructions for a field need to change depending on earlier answers.

For example, using the same scenario from Advanced Label:
If you have a dropdown called Feedback Type with options like “Service Feedback” and “Product Feedback”, you may want the description of your Ratings field to guide the user differently depending on what they selected.

So:
– If the user selects Service Feedback, the description could say: “Rate the customer service you received.”
– If the user selects Product Feedback, the description could say: “Rate the product’s performance and quality.”

Formula:

This helps users understand what is required from them without showing unnecessarily long or irrelevant instructions.

‍

Additional Examples (Apply to Both Advanced Label and Advanced Description)

1. Showing nothing until a selection is made

For example, if you have a dropdown field called Visit Category with options “Routine” and “Urgent”, you may want the label or description of a field to remain blank until the user first selects a category.

Once a selection is made:

• If the user chooses Routine, the field will display “Routine”.
• If the user chooses Urgent, the field will display “Urgent”.

Formula (can be used in either Advanced Label or Advanced Description):

The label/description stays empty until the dropdown has a selected value.
After the user picks an option, the selected text (Routine or Urgent) becomes the label or description.

2. Changing label/description based on language selection

For example, if your form includes a dropdown field called Select Language with options English, Spanish, and French, you can show the label or description in the selected language.

So:

• If the user selects English, show English text.
• If the user selects Spanish, show Spanish text.
• If the user selects French, show French text.

Formula (can be used in either Advanced Label or Advanced Description):

The formula returns the text for the selected language.
Only one label/description is shown at a time, depending on what the user picks in the Select Language dropdown.

‍

Important Notes (applies to both Advanced Label and Advanced Description)

1. Variables do not change
When a field is created, its variable name is derived from the label you set in the Basic tab. That variable name is what you must use in formulas, workflows, and other logic. The visible label or description shown by Advanced Label / Advanced Description does not change the variable name.

2. Submissions tab: table view vs right panel
In the Submissions area, the table view always displays the labels from the Basic tab. When you open an individual submission, the right panel shows the labels and descriptions as they appear in the form (i.e., the Advanced Label and Advanced Description applied for that submission). This keeps the submission list consistent while letting reviewers see the context-aware labels and descriptions when viewing a record.

3. Bulk Edit shows Basic tab labels and descriptions
When you need to Bulk Edit submissions, the spreadsheet you download shows the labels and descriptions from the Basic tab only. Advanced Label and Advanced Description are not applied in Bulk Edit, so keep that in mind when preparing bulk updates.

4. Some fields cannot be used inside Advanced Label/Description formulas
Certain block types do not expose a variable that can be referenced in Advanced Label or Advanced Description. If a block does not expose a variable, you cannot use it inside the formula.