Application.AddCustomList method (Excel)

Adds a custom list for custom autofill and/or custom sort.

Syntax

expression.AddCustomList (ListArray, ByRow)

expression A variable that represents an Application object.

Parameters

Name Required/Optional Data type Description
ListArray Required Variant Specifies the source data, as either an array of strings or a Range object.
ByRow Optional Variant Only used if ListArray is a Range object. True to create a custom list from each row in the range. False to create a custom list from each column in the range.

If this argument is omitted and there are more rows than columns (or an equal number of rows and columns) in the range, Microsoft Excel creates a custom list from each column in the range.

If this argument is omitted and there are more columns than rows in the range, Excel creates a custom list from each row in the range.

Remarks

If the list that you are trying to add already exists, this method throws a run-time error 1004. Catch the error with an On Error statement.

Example

This example adds an array of strings as a custom list.

On Error Resume Next  ' if the list already exists, do nothing
Application.AddCustomList Array("cogs", "sprockets", _ 
 "widgets", "gizmos")
On Error Goto 0       ' resume regular error handling

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.