Creating a Custom List

A custom list is a list of values that you can use in custom fields on your forms and records. Custom lists enable you to set up predefined choices for your employees and customers to select when entering transactions and records. You can create an unlimited number of custom lists and an unlimited number of values for each list.

You can use CSV import to import large custom lists. For information, see Custom List Import.


Custom lists can be used to set up options for matrix items. For details, see Setting up an Item Matrix.

To create a custom list:

  1. Go to Customization > Lists, Records, & Fields > Lists > New. The Custom List page appears.

  2. In the Name field, enter a name for the list.

  3. In the ID field, enter a unique alphanumeric ID for the custom list. For information about best practices and naming conventions, see Conventions for Naming Custom Objects. For information about changing an existing ID, see Changing the ID of a Custom Object.

  4. Select the owner of the custom list. By default, you are selected as the owner.

    Only the owner and users with edit or full permission levels can modify the custom list.

  5. Enter a description of the custom list.

  6. By default, values are listed in the order in which they are entered. To list values in alphabetical order, click the alphabetical order radio button.

  7. If the list is for matrix items, check the Matrix Option List box.

    If you check the box, an Abbreviation column is added to the Values list.


    The Accounting Matrix Items feature must be enabled to use the matrix lists option. If it is not enabled, the Matrix Option List box is not displayed.

  8. In the Value field, enter a value for the list.

  9. Click Add.

  10. Add values to the list as needed.

  11. Click Save.

The custom list can now be used in your custom fields. For details, see Creating a Custom Field and Adding Translations for Custom Lists.

You can use SuiteCloud Development Framework (SDF) to manage custom lists as part of file-based customization projects. For information about SDF, see SuiteCloud Development Framework Overview. You can use the Copy to Account feature to copy an individual custom list to another of your accounts. Each custom list page has a clickable Copy to Account option in the upper right corner. For information about Copy to Account, see Copy to Account Overview.


Custom lists are intended for use with small, fixed, related sets of data. Custom lists should include no more than 1000 values.

Related Topics

Custom Lists
Adding Translations for Custom Lists
Managing Large Custom Lists

General Notices