Checkboxes

The Checkbox question allows the selection of one or more options. One of it's uses is with a single option as an "I agree with the Terms and Conditions" checkbox.

Config

• Show as

  If you need a single option to be selectable at a time, you can change it with the Radio Buttons or the Dropdown List.

• Required

  At least one option needs to be checked.

• Title

  The title of the question. You can show the value of other questions by writing {{QA}}, {{QB}}, etc

• Hide Title

  Hide the question title.

• Help Text

  A description text that goes after the question.

• Inline

  Display the options on the same line

• Use images

  Use images instead of checkboxes. You can upload images next to each option (pre-optimized images work best). Clicking on an image shows a green checked mark on the image.

• Add descriptions for each option

  If you need a description text for the options activate it here.

• Options

  Each option has at least a Title and a Value. The value can be used in formulas. You can pre-check an option using the checkbox on it's left. Drag an option by the handle on the left side if you need to re-order them.

• Tooltip Text

  A question mark will show after the question with a tooltip text that you can set here.

• Show Values in Email Report

  If you want to send an email to the person submitting the calculator you can chose to show the value of each option in the email.

• Prefix

  If you ticked "Show Values in Email Report" you can add a prefix to the values, like a currency symbol

• Suffix

  If you ticked "Show Values in Email Report" you can add a suffix to the values

• Conditional Visibility

  Set the visibility based on a formula called the Visibility Formula. If the Visibility Formula result is true, the question will be shown in the calculator, otherwise it will be hidden. This allows you to show the question only in certain conditions, for example when another question has a certain value.

• Set value when hidden

  All fields have the value zero when hidden, except for formulas, which keep the same value whether hidden or not.
  Tick this box to set a custom value when hidden, or to keep the same value when hidden as when visible.

Style

Most of the style settings are self-explanatory, but here are a few tips and tricks:

• Colors

  You can set the Question Text Color, Background Color, Help Text color, by using the color picker. The colors use the Hexadecimal code. If you want to reset a color just delete the value.
  Tip: you can set a color to transparent by typing "transparent" in the color box.

• Field Width

  You can set a width for the field (Full width, One half, One third or One fourth). This allows for multiple Questions to sit side by side. Note that on small screen sizes the questions will be reset to full width for usability purposes.

• Align

  Set how the Question content is align. Inline will set the question title and the content on the same line.
  The "Inline Position" setting helps position the Title and the Content:

  • Left - the Title and the Content are both on the left side
  • Middle - the Title and Content are both on the middle of their containers
  • Ends - The Title is on the left and the Content is on the right side

• Add a CSS attribute based on a Formula

  The result of this formula will be added as an attribute to the ".ic-question" parent element of the field/question.

  The attribute is called "formula-attribute", and you can then use it in CSS code to change the way the question looks based on the formula. For example, you could change the background color of the field/question based on a formula.

  For example you could have the "CSS Attribute Formula" be:

  IF(@FormulaField < 10, 'red', 'blue')
  And then in Settings / Design / Custom CSS Code you can add:
  
  .ic-question[formula-field='red'] { background-color: red; }
  .ic-question[formula-field='blue'] { background-color: blue; }
• CSS Class

  Useful for custom CSS/Javascript code. This allows you to change how this particular question looks or works using custom coding.

How it works in Formulas

When referenced in formulas like @CheckboxField, it's value is the sum of the checked options. If no options are checked, it's value is zero.

If you need to know if a certain option was checked, you can use the CHECKED function in formulas like this:
CHECKED(@CheckboxField, value) will be 1 if the checkbox field has the option with value "value" checked, 0 otherwise

For example, if you have a checkbox with options:
Oranges = 1
Apples = 2
Bananas = 3
CHECKED(@CheckboxField, 3) will be 1 when Bananas is checked (regardless of what else is checked), and 0 otherwise

If you want to show the label of the checked option in a formula field, use the LABEL function:
LABEL(@CheckboxField)
If multiple options are checked, they will be separated with a comma.

LABEL(@CheckboxField, " + ") will separate them with a plus sign, or you can use whatever separator you like in the second argument.

You can concatenate them like this:
LABEL(@RadioField) & LABEL(@CheckboxField) & " Some other text here"