Expand IntroductionIntroduction
Expand AdministrationAdministration
Expand User InterfaceUser Interface
Collapse SOLIDWORKS FundamentalsSOLIDWORKS Fundamentals
Basic Concepts
Basic Commands: Cut, Copy, Paste, Undo, and Redo
Expand Help, Search, and Web ResourcesHelp, Search, and Web Resources
Expand Document BasicsDocument Basics
Expand Overview of SOLIDWORKS OptionsOverview of SOLIDWORKS Options
Expand DisplayDisplay
Expand SelectionSelection
Collapse File PropertiesFile Properties
Summary Information
Expand Summary Information - Custom and Configuration SpecificSummary Information - Custom and Configuration Specific
Blank Custom Properties
Using Custom and Default File Properties in Equations
Expand Mass Properties and Section PropertiesMass Properties and Section Properties
Collapse Property Tab BuilderProperty Tab Builder
Property Tab Builder Overview
Creating a Tab
Editing a Tab
Expand Property Tab Builder Conditional ListsProperty Tab Builder Conditional Lists
Collapse ReferenceReference
Element Types
Page-Level Attributes
Groupbox Attributes
Textbox Attributes
List Attributes
Number Attributes
Checkbox Attributes
Radio Button Attributes
List Group Attributes
Expand Measure ToolMeasure Tool
Expand SensorsSensors
Expand EquationsEquations
Mirror and Opposite-Hand Disambiguation
Expand Industry-Specific Design ToolsIndustry-Specific Design Tools
Xperts Overview
Expand Object Linking and EmbeddingObject Linking and Embedding
Expand Recording and Playing MacrosRecording and Playing Macros
Future Version Components in Earlier Releases
Expand  SOLIDWORKS Task Scheduler SOLIDWORKS Task Scheduler
Expand TasksTasks
Expand OptionsOptions
Expand Moving from 2D to 3DMoving from 2D to 3D
Expand AssembliesAssemblies
Expand CircuitWorksCircuitWorks
Expand ConfigurationsConfigurations
Expand Design CheckerDesign Checker
Expand Design Studies in SOLIDWORKSDesign Studies in SOLIDWORKS
Expand Detailing and DrawingsDetailing and Drawings
Expand DFMXpressDFMXpress
Expand DriveWorksXpressDriveWorksXpress
Expand FloXpressFloXpress
Expand SLDXML Data ExchangeSLDXML Data Exchange
Expand Import and ExportImport and Export
Expand Model DisplayModel Display
Expand Mold DesignMold Design
Expand Motion StudiesMotion Studies
Expand Parts and FeaturesParts and Features
Expand RoutingRouting
Expand Sheet MetalSheet Metal
Expand SimulationSimulation
Expand SimulationXpressSimulationXpress
Expand SketchingSketching
Expand SOLIDWORKS UtilitiesSOLIDWORKS Utilities
Expand SOLIDWORKS SustainabilitySOLIDWORKS Sustainability
Expand TolerancingTolerancing
Expand TolAnalystTolAnalyst
Expand ToolboxToolbox
Expand WeldmentsWeldments
Expand Workgroup PDMWorkgroup PDM
Expand TroubleshootingTroubleshooting
Hide Table of Contents

List Attributes

List boxes present users with a list of predefined text values.

You can populate the list by typing values or importing them from a text file or Excel spreadsheet.

Drag a list box from the palette on the left into a group box in the center pane. In the pane on the right, set attributes as described below.

The attributes of lists within List Groups are different from standalone list, and are described in List Group Attributes.

Control Attributes

  Caption Enter text for the label on the list box.
Parent Lists elements that precede the List control. You can select one of these controls as a parent for conditionalized lists.

Custom Property Attributes

Name Controls the name of the custom property the user is creating in SOLIDWORKS. You can type any name or select a standard name from the drop-down list (populated by your existing properties.txt file).
Type Controls the information that is valid for the user to enter in the text box. You select:
  • List to type values.
  • Text File to import values from a text file.
  • Excel File to import values from an Excel spreadsheet.
When you import values from an external file, the link to the file is maintained. Changes you make later in the external file are reflected the SOLIDWORKS interface. If you make changes when a user has SOLIDWORKS open, the user needs to click in the Custom Properties tab and then press F5 to refresh the screen.
Value (Available when Type is List.) Controls the list of values displayed in the SOLIDWORKS interface.
Path (Available when Type is Text File or Excel File.) Specify the path to a file that contains the list of values.
Range (Available when Type is Excel File.) Specify the cells in the Excel file that define the list, in the format first cell:last cell.


  • A1:A10 reads values in cells A1 through A10.
  • A1:B4 reads values in cells A1 through A4, then B1 through B4.
Allow custom values Allows users to manually type text values into the box in the SOLIDWORKS interface. When this option is cleared, users can only select values from the list.
Configurations (Not available when the template type is set to Drawing in page-level attributes.)

Show on Custom Tab. Writes the property the user creates to the Custom tab of the Summary Information dialog box.

Show on Configurations Tab. Writes the property the user creates to the Configuration Specific tab of the Summary Information dialog box.

Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

Subject:   Feedback on Help Topics
Page:   List Attributes
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:


We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again

Web Help Content Version: SOLIDWORKS 2017 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.