All and None of Above for Multi-Select Buttons

Digioh supports Multi-Select Buttons that act like checkboxes and are mapped to Custom Fields. These are button elements with action "Select Button" and when clicked the button highlight toggles on and off along with the field value being set and cleared respectively:

Sometimes you may want to implement a preset group of buttons that toggle on and off together. A typical example would be if you had an "All of the Above" and/or "None of the Above" buttons. To do this, you'll need the extension "Multi-Select All & None of Above Buttons".

To install this, go to your profile menu and select Extensions, find it under "Button customization" in the list, and click Install.

Once installed, you can configure button (element) level metadata as follows:

• select_option=groupName - add to buttons that are to select and deselect together as a group
  
  
• select_none=groupName - add to one (or more) buttons that when clicked will deselect the groupName group
  • Any buttons using this metadata will also need select_options : true
    
    
• select_all=groupName - add to one (or more) buttons that when clicked will select the groupName group
  • Any buttons using this metadata will also need select_options : true
    
    
• select_only=groupName - add to all buttons on a page when only one button will be selected in the groupName group

Here, groupName can be whatever you want, but it needs to be consistent for buttons that work together. Group names are case-insensitive and leading/trailing whitespace is ignored ("My_Group", "my_group", and " my_group " are all the same group), but we recommend sticking to consistent lowercase names (e.g., "quiz_group1") to avoid ambiguity.

You must use either select_none, select_all, or both, for select_option to have any effect.

You can have any number of button groups on any number of pages, but group names do not work across different pages, meaning two buttons on different pages with the same group name are treated as independent groups.

Note: Only one select_all button and one select_none button is allowed per group. Adding a second of either throws an error in the Notification Log and stops the extension from loading.

Example: select_none configuration (also requires select_options = true):

Example: select_option configuration (add to buttons that are to select and deselect together as a group):

How the Buttons Interact

The extension keeps the group state consistent automatically, with no additional configuration:

• Clicking the None of the Above button deselects all option buttons and also deselects the Select All button (if one exists in the group).

• Clicking the Select All button deselects the None of the Above button (if one exists in the group).

• Clicking any individual option button deselects the Select All button (since "all" is no longer accurate).

Using select_only for Exclusive Selection

For select_only, no select_option is necessary. Each button on the page will need to have the metadata key and value added to it as shown below:

Preselecting a Button

This extension also supports preselecting a button. You can configure button (element) level metadata for preselecting a button:

• select_autoselect=true

Note: select_autoselect runs on the initial page load and again whenever the visitor navigates between pages in a multi-step campaign. This means if a visitor deselects a pre-selected button, navigates to another page, and then comes back, the button will be re-selected automatically.

Limiting the Number of Selections

You can require a minimum, maximum, or exact number of selections using metadata keys built into this extension:

• select_btn_range = groupName (Element metadata) - add to each button that counts toward the limit. This enforces the maximum on every click: if the visitor tries to select more than the max, the click is rejected and the error message appears immediately.

• select_btn_count = n or n-m (Page metadata) - add to the page layout element, not a button. Defines the required count as an exact number (e.g., "3") or a min-max range (e.g., "2-4"). Validates when the form is submitted.

• select_error = your error text (Page metadata) - add to the same page element as select_btn_count to customize the error message shown when validation fails. Default: "Must select appropriate number of options".

For example, to require visitors to select between 2 and 4 options: add select_btn_count = 2-4 to the page, select_btn_range = groupName to each option button, and optionally select_error = Please choose 2 to 4 options to the page.

Deselecting a Multi-Select Group When a Text Field Has a Value

In some use cases, you may want a text field to automatically clear any selected buttons in a multi-select button group. This allows you to offer an “Other (please specify)” free-text option that behaves like a mutually-exclusive input.

How It Works

When the visitor types into the configured text field:

• All buttons belonging to the specified group will immediately be deselected.

• If the visitor clears the text field, their previous button selections are restored.

• The text field value will then be used for downstream submission or mapping (e.g., to a custom field).

How to Configure It

1. Identify the group name used by your select_only or select_option metadata for the button group.

2. Open the metadata for the text field that should clear the group.

3. Add the following metadata key/value pair: clear_select_only = groupName

The groupName must match the exact group name used by the rest of the multi-select buttons.

For example:

Full Metadata Reference

Troubleshooting

If your buttons aren't responding or the extension doesn't seem to be working, check the Notification Log (bell icon) in your Digioh dashboard. The extension logs a specific error for each misconfiguration, and configuration errors (wrong Button Action, duplicate select_all or select_none buttons in a group) stop the extension from loading for that campaign.

Running into an issue or have a question? Reach out to our support team via support@digioh.com and we'll be happy to help!