---
sourceDocument: Yokohama ServiceNow AI Platform Capabilities
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Check box

# Check box {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Check box

The check box variable in ServiceNow enables users to select or clear options, making it useful for toggling settings or confirming agreements.
It supports mandatory selection by enabling theSelection Requiredoption, which ensures users cannot submit a form without selecting the check box (e.g., agreeing to terms).
Show full answer Show less  

## Key Features

* **Mandatory Check Boxes:** Making a check box mandatory enforces user selection before form submission, triggering alert messages if unchecked.
* **Grouping:** Consecutive check box variables automatically form a group sorted by their order. Groups can have custom labels by adding a label variable at the start.
* **Group Behavior:**
  * If any check box in a group is mandatory, the entire group becomes mandatory, requiring at least one selection.
  * An asterisk () indicates the mandatory status next to the group label.
  * Hiding the group label hides the entire group of check boxes.
  * If all but one check box in a mandatory group are hidden and unselected, the last visible check box cannot be hidden if unselected.
* **Service Portal:** To make a check box group mandatory, set at least one check box in the group as mandatory. Setting the label variable itself as mandatory does not enforce group mandatory behavior.
* **Catalog Builder:**
  * Two or more consecutive check boxes create a virtual container grouping them.
  * Only check box variables can be added inside this group container.
  * Any check box added immediately after the group automatically joins it.
* **Pricing Configuration:** Under Type Specifications, you can define prices for check boxes in multiple currencies and pricing models such as Calculated, Fixed, or Multiple.

## Practical Application for ServiceNow Customers

This functionality is essential for creating interactive, user-friendly forms where options need clear user confirmation or selection. The grouping and mandatory features ensure data integrity and compliance (e.g., agreement acceptance). The catalog builder's grouping behavior simplifies variable management and enforces consistent UI behavior. Pricing configurations allow for flexible cost modeling within service catalogs.  
The check box variable lets you enable and disable options by selecting and clearing it.

To make a check box mandatory, select the Selection Required option when you create the variable. For example, use this option to require users to select the I agree check box for an
agreement form. If users try to submit the agreement form without selecting the check box, an alert message is displayed to tell users that they must select the check box.

A group of check box variables is created when you create consecutive check box variables. These check box variables are sorted by their order within the group. If you want to define a custom label for the group of check boxes, create
a label variable at the start of the consecutive check box variables. The label is then considered a part of this group and acts a label of the group. If there is no custom label, check boxes are grouped under an
Options label by the application.  
In a group of check box variables:

* If any check box variable in the group is mandatory, the entire group becomes mandatory irrespective of the visibility of the mandatory check box variable. An asterisk (\*) is then displayed next to the group label and you must select at least one of these check boxes.
* Hiding the label hides the entire group.
* If all other check box variables of a mandatory check box group are hidden and not selected, the following scenarios are applicable:
  * The group remains mandatory as long as there is one check box in the group that is visible and not selected.
  * The last check box of this group cannot be hidden if it is not selected.
  {#check-box__ul_sn3_mw5_sfb}
{#check-box__ul_hdr_kw5_sfb}

In Service Portal, to make a group of check box variables mandatory, set at least one of the check box variables as mandatory. While defining the label for a group of check boxes, setting a label mandatory does not make the group of
check box variables mandatory.  
In catalog builder, the following scenarios are applicable:

* If there are two consecutive check boxes, then a virtual container is created for a group of check boxes. Only check box variable types can be added inside the group
* Even if a check box variable is added immediately after a group of check boxes, it is automatically added to the group.
{#check-box__ul_cww_j5t_h4b}  
Under the Type Specifications tab, you can specify the price in different currency types. Also, you can configure the price in the following pricing models:

* Calculated
* Fixed
* Multiple

{#check-box__ul_svg_yrn_tz} For information on the pricing models, see [Price fields](https://www.servicenow.com/docs/access?context=price-fields&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US) .  
Figure 1. Example: check box variable
**Related concepts**   

* [Attachment](https://www.servicenow.com/docs/QO6tabzhZQAmG~fTm~Oxvg "When submitting a catalog item request, this variable lets you upload an attachment for a question of the item.")
* [Break](https://www.servicenow.com/docs/ZPkcnLIOoUJ0KUAwbkZq1Q "The break variable displays a horizontal line across the form.")
* [Container start, container split, and container end](https://www.servicenow.com/docs/pC3s_06HYIQ2nYqGR3zVTQ "The container start, container split, and container end variables define a layout for a container that can hold more variables.")
* [Date, Date and time, and Duration](https://www.servicenow.com/docs/uzlw6WNmuwB3x01yjFA0pQ "The date variable creates a widget with a field and calendar to select a date.")
* [Email](https://www.servicenow.com/docs/e05Xnwb1dlr3HvDFYMK85w "The email variable creates a widget to enter and select an email address.")
* [HTML](https://www.servicenow.com/docs/vEd~WSLcnLEnCKxB4dWLrw "The HTML variable lets you provide content with advanced formatting, including images, for a catalog item.")
* [IP Address](https://www.servicenow.com/docs/qSWnkVruJD2Cbdub~ODQ2w "Use the IP address variable to specify the IPv4 and IPv6 data for a catalog item.")
* [Label](https://www.servicenow.com/docs/55~SxLwA_bs95JADgcA79w "The label variable displays a label across the form. Labels are formatting elements. No data is collected.")
* [List collector](https://www.servicenow.com/docs/PBw_niFNS0zVn7ZJIcBonQ "The list collector variable creates an interface that lets you select and add multiple records from a table.")
* [Lookup multiple choice](https://www.servicenow.com/docs/10gK7f2avwj7NEyP2~BFlg "The lookup multiple choice variable creates radio buttons using data from a table. Its functionality is similar to the lookup select box variable, which creates a choice list from queried data.")
* [Lookup select box](https://www.servicenow.com/docs/sHCOcg~Iem_zOUhSXLPrvg "The lookup select box variable creates a choice list using data queried from a table. Its functionality is similar to the lookup multiple choice variable, which creates radio buttons from queried data.")
* [Custom and Custom with label](https://www.servicenow.com/docs/7kVwkVNouYvNWsWUJRTR9Q "The custom variable inserts a UI macro into the catalog item. Custom with label variable inserts a UI macro with a label.")
* [Masked](https://www.servicenow.com/docs/hwnWO2P~80q7qhbXika9yg "The masked variable inserts a field that masks the text entered.")
* [Multi-line text](https://www.servicenow.com/docs/fFQDuJAidoKgNq_Z8P1xNQ "The multi-line text variable creates a field that lets you enter multiple lines of text.")
* [Multiple choice](https://www.servicenow.com/docs/IpqZmjpq1v5Rf28NHh645A "The multiple choice variable creates radio buttons for question choices.")
* [Numeric scale](https://www.servicenow.com/docs/2I4UDB_n8iMVzpTMChLB2Q "The numeric scale variable creates a set of radio buttons for a range of options, like a Likert scale.")
* [Reference](https://www.servicenow.com/docs/m7TquCi~aKhtuV~EOj14Qw "A reference variable references a record in another table. For example, a variable named point_of_contact references the User [sys_user] table.")
* [Requested for](https://www.servicenow.com/docs/N2sHQov681zrbqCejbA~Dw "Before submitting a catalog item request, this variable helps you specify who this request can be submitted for.")
* [Rich Text Label](https://www.servicenow.com/docs/vUsX7U3OToPdlSQGu~MxMQ "This variable displays a formatted label on a catalog item form.")
* [Select box](https://www.servicenow.com/docs/mTLXDo1f0knfdn1BrNg~Sg "The select box variable creates a list from predefined question choices.")
* [Single-line text](https://www.servicenow.com/docs/F91A9HDH34PCsK~w5SK_5w "The single-line text variable creates a field to enter a single line of text.")
* [UI page](https://www.servicenow.com/docs/lmwv0niDqrzcCUzj~AL0fA "The UI page variable inserts a UI page into the catalog item.")
* [URL](https://www.servicenow.com/docs/K~Kn8iqfU_N6FMpwJa~sSA "The URL variable creates a widget for users to enter URLs.")
* [Wide single-line text](https://www.servicenow.com/docs/9xTczJ~RQ3vCeGDfA9DYCw "The wide single-line text variable creates a field that spans the form, letting users enter longer lines of text.")
* [Yes/No](https://www.servicenow.com/docs/42KYd19QsroLGxZ5n~M_2Q "The Yes or No variable creates a choice list with Yes and No as options.")  
**Related reference**   

* [Variable support in various channels](https://www.servicenow.com/docs/_FSp~~cB0QAPSeTClzNhmQ "Service Catalog variables are supported in various channels.")