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, don'thing
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.