Category Field

This feature available on All Plans

Overview

The Category Field is a custom field with unique properties that enhance form functionality. This guide outlines all the features and settings available for the Category Field.

Getting There

1. In the Campaign Builder, drag and drop the Field Widget into a Form Container.
2. In the pop-up, select Category from the Custom Field list.
3. Click Next to proceed.

Field Settings

Layout

Allow Multiple Selections

If entrants can select more than one category, check the Allow Multiple Selections box. Layout options include:

• List: Displays all categories; entrants click to select their choices.
• Checkboxes: Categories appear with checkboxes for selection.
• Tiles: Categories appear as tiles, which are suitable for adding images.

Note: When multiple categories are allowed, vote counts reflect the total votes across all selected categories for an entry.

Single-Selection Layout Options

If multiple selections are not allowed, layout options include:

• Dropdown: A classic dropdown menu for single selection.
• Radio Buttons: Categories are displayed with radio buttons for selection.
• Tiles: Displays categories as tiles with image support.
• Text: A blank text field where entrants manually enter a category. (Case-sensitive when using Text Layout)

Text

Assign Labels or Prompts (for dropdown layouts only) in this section to guide entrants.

Validation

Make the field mandatory by checking the Required box.

• Click Show advanced options for additional settings:
  • Always Required: Field is always mandatory.
  • Conditionally Required: Field is mandatory only when visible.

Error Messages

Customize error messages by entering your desired text in the appropriate fields.

Content

Define your categories in this section.

Input Modes

• Text Input Mode:
  • Type each category on a separate line.
  • Capitalization matters when using the Text Layout.
• Prompted Input Mode:
  • Enter choice text, add a value (e.g., monetary value for certain templates), and optionally add an image.
  • Use the + icon to upload an image via the Media Library.
  • Add a new choice with the Add Choice button.
  • Delete choices with the trash can icon.

Default Value

Select a default category or leave it blank to keep the field unselected initially.

Field Points

Assign a point value to the field to award entrants additional points for completing this field.

Other

Instructions Field

Add text to the Instructions field to display below the field when it is focused (selected).

CSS Classes

Add custom CSS classes to the Extra CSS classes field for styling via the CSS Editor.

Visibility

Control field visibility by:

• Date and Time: Limit field visibility to a specific period.
• Pop-Up Display: Show the field as a pop-up.
• Builder Only: Limit field visibility to the Campaign Builder.
• Country Restrictions: Show the field only in specific countries.

For more details, see the Widget Visibility Help Doc.

Extras

Learn more about the Main Tag, CSS Classes, and Smart Labels settings in the Widget Extras doc.