Form List Box

Xodo PDF Studio is capable of creating List Boxes. List Boxes are used to allow users to select an option from a list of available text options from a scrollable window within the PDF document.


Creating List Boxes

  1. Start the Form Editing Mode by going to the Forms Tab
  2. Click on the List Box button located on the tool bar. The cursor will then change to show a preview of the field
  3. Using the mouse move to the location you want to place the field and then click to place the field or click and drag to create a custom field size.
  4. The List Box Properties dialog will then be displayed so that you can add the options to the list as it will initially be blank.
  5. Click on the Options tab
  6. Type in each of the options that you wish to add in the Item field and then click on Add or press Enter on your keyboard. Your new item will be displayed in the list below. Continue adding all the items that you need and once complete click on OK to set the list options
  7. Repeat steps 1-6 to create as many fields as you need
  8. To finish placing List Boxes press Esc or click on the button on the toolbar

List Box Properties

To access the List Box properties right click (Mac: Ctrl + Click) on the field and choose Properties in the mouse menu or click on the edit button on the Mini Toolbar. The List Box contains the following property settings.


Name - The name of the field

Tooltip - The tip that is shown when the mouse is hovered over the field


Font - Sets the font of the text

Size - Sets the font size of the text

Text Color - Sets the text color

Border Color - Sets the color of the border

Line Width - Sets the width of the border line

Fill Color - Sets the fill color

Style - Sets the style for the border line (i.e. dotted, dashed, cloud, etc...)

Save as default - When checked this will make the selected style settings the default for any new List Boxes going forward


Rotation - Sets the field rotation in 90 degree increments

Required - This option is not available on List Boxes

Visibility - Sets one of four visibility options for the field

      • Show: the default setting makes the field visible
      • Hide: hides the field from being displayed when viewing the document
      • Show/Do not print: shows the field but will not print the field or it's values
      • Hide/Print: hides the field but the field and its value will be printed

Read Only - Makes the field uneditable and will just display the value currently set in the field

Locked - When checked prevents the following on the field: being moved or resized, editing appearance properties, & deleting the annotation.


Item - Type the name of the item you would like to add to the List Box list

Add - Adds the text in the Item field to the List Box list

Export Value - The value to be exported when the Item is selected in the List box

Default - When checked, this will make the selected option the default value of the field. This is the value that will be displayed if the field is empty or when Resetting Form Fields

Delete - Deletes the selected items from the list

Move Up - Moves the selected item up the list

Move Down - Moves the selected item down the list

Allow Multi Select - When checked, allows the user to select multiple options using either Shift or Ctrl + Click

Sort Items - Will alphabetically sort all of the items in the list

Note: This cannot be undone after it has been sorted you will need to manually resort the items

Commit Selected Immediately - When using Form Field Calculations this will submit the value to the calculation (if set) immediately. Otherwise, it will need to be triggered using another method.

Selection Change

Allows you to set an action to occur when a selection is changed. Only JavaScript can be used when setting change actions.

Do nothing on selection change - Default value, sets no validation rules and any value can be entered into the field

Do custom script on selection change - When selected you will need to use Form JavaScript to create custom validations


The Action Panel displays a list of the current actions associated with the field. Actions can be added, edited, or deleted using the buttons below the actions list.

Add - Adds a custom Form Field Actions from a list of available actions.

Edit - Edits the currently selected action from the list

Remove -  Removes the currently selected action from the list