Listbox Properties

Use the Listbox properties pane to add a control lets users select from a predefined list of values.

To display the properties pane:

In the Card Editor, click List (Controls toolbar), and click in the card to place the list box.

Items (SOLIDWORKS PDM Professional only)

Select the items to show in the list. The values can be retrieved from predefined lists, centrally administered lists, or static item lists.

Special value

Select a predefined list to populate the control's list.
User list (xx)

Lists all vault users, showing the login name, initials, full name, or user data from the user profile card.

Group list

Lists all vault groups.

State list

Lists all workflow states.

Workflow list

Lists all vault workflows.


Predefined lists showing values from the local StdVal_xx.Lan file. Update the file on all clients to add more values.

XXX - Centrally administered card lists.

See Central Card Lists (For SOLIDWORKS PDM Professional only).

Free text

Enter items, one per row, to display in the list control.

Controlled by variable

In the data card, the available list values depend on a value selected in another list or edit box.

See Creating Dynamically-controlled Card Lists.


Displays the Controlled by variable dialog box, where you associate the values in this control with the values in another control.


Variable name

Select the data card variable to store the value selected from the list.


Click to open the Edit Variables dialog box to create a new variable, or check the properties of an existing variable.



Makes the list read-only, so that values cannot be entered by the user.

Show in Explorer

The variable and stored value of the list is shown in the client Preview tab.

Updates all configurations

All file data card configuration tabs are updated by the value entered in the list.

Default value

Select an option to automatically enter a default value in the list when new files are created. See Assigning Default Values.

Specify value

Select the list value to be used as the standard value.

For the user and group lists, you can also select the currently logged in user or group.

Folder data card variable

Select a folder data card variable whose value will be used as the default value.

For example, if you select the folder data card variable Customer and the folder data card has a value of IBM, when a user adds a new file to the folder, the list is filled in with the default value IBM.

File data card variable

(SOLIDWORKS PDM Professional only)

(Item cards only.) Select a file data card variable whose value will be used as the default value.

For example, if you select the file data card variable Customer and a file has a value of IBM, when a user creates a new item from the file, the list is filled in with the default value IBM.

When creating items for configurations, values come from the referenced configuration, or if empty, the custom properties (@ tab). Therefore, if you want item card values to exactly match configuration values, ensure that all mapped configuration variables have values by defining those properties as required. Alternatively, do not use custom properties.

When creating items for CAD files (not specific configurations), values come from the custom properties.

Default overwrites

Overwrites the existing variable value with the default value when users copy or add files.

Excluded Configurations Configurations from which to exclude default values.

Exclusion occurs when files are added to the vault or when the addition of a new configuration generates default values.

Type one configuration name per line.

You can use * as a wildcard. For example *magnet* excludes all configurations with "magnet" in the configuration name.

Configurations are not excluded if users manually generate serial numbers.