> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowforma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ExistingListPicker

> Use the FlowForma ExistingListPicker widget to let users choose a SharePoint list from a drop-down, as when configuring a Get List Data rule.

## Function

FlowForma.Widgets.GetExistingListPicker(container, value, options)

## Description

This function creates FlowForma picker, that will let you select steps and questions from a drop-down box.

## Uses

An example of where this would be used would be when configuring a "[Get List Data](/product/creating-flows/business-rules/business-rule-types/data-integration-rules/get-list-data)" rule, you will need to select a list.

<img src="https://mintcdn.com/flowforma/g56Im1vOp6-ECYen/images/developers/widgets/existinglistpicker/existinglistpicker-1.png?fit=max&auto=format&n=g56Im1vOp6-ECYen&q=85&s=66385da06266779e81301ca3577d5642" alt="ExistingListPicker drop-down" width="724" height="872" data-path="images/developers/widgets/existinglistpicker/existinglistpicker-1.png" />

## Variables

**container**:

*Format* - jQuery input element. (Example: \$("#listPicker")).

*Description* - This element will be used to build the FlowForma list picker on to.

**value**:

*Format* – Stringified JSON object.

*Description* – If the variable is defined it selects the defined list, otherwise nothing is selected.

**options**:

*Format* – Object. (Example: `var options = { AllowCustomText: true, AllowCustomLists : true }`).

*Default options* – AllowCustomText = false;

AllowCustomLists = false;

AllowDocLibs = false;

*Description –* Allows to set custom functionality to the widget.

## Properties and functions

FlowForma list picker object has few functions and properties and can be retrieved as shown below:

var picker = \$ ("#listPicker").data("ExistingListPicker");

**Functions:**

*Picker.OnCallBack() -* This is triggered when the list is selected.