--- title: "Create a Dynamic List" slug: "create-a-dynamic-list" description: "Learn how to use Dynamic Lists to populate form elements with external services, enhancing user experience with autocomplete and reusable fields." updated: 2026-10-16T19:15:50Z published: 2026-10-16T19:15:50Z canonical: "www.civicplus.help/create-a-dynamic-list" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Create a Dynamic List Dynamic Lists allow you to populate autocomplete, select, radio, or checkbox form elements. Where Lists are able to be configured in the platform, Dynamic Lists allow you to call external services using an API. View the [Create a List](/process-automation/docs/create-a-list) article for information on how to populate form elements with reusable fields. ## Instructions [Embedded content](https://www.iorad.com/player/1910993/CivicOptimize--How-to-Create-an-Option-Set-Practice-Tutorial) 1. [Sign in to your site](/process-automation/docs/sign-in-to-your-site) 2. Navigate to **Developer Tools** and select **Dynamic Lists**![The Dynamic Lists option under the Developer Tools navigation menu.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Dynamic%20Lists%20Menu%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=vGkAkV%2FUEqMVq6weLAP8Iwkhdlogw4Az%2F%2FyC%2BGrLa2A%3D) 3. Click the **+** button in the bottom right corner ![The Add Dynamic List button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Add%20Dynamic%20List%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=No9mmsg3GJuj%2BSbeJxQ3QRY09APFEgyio3KuAmln3Po%3D) 4. Choose **Custom** **URL** or **Hosted API** as the source for your list ![Options for creating a new dynamic list with Custom URL and Hosted API buttons.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/New%20Dynamic%20List%20Options%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=wnFPZYnDgeY79doyu36SydcpFrIz47Dlyi7B3dlscdY%3D) - **URL:** Enter a URL to pull the dynamic list from - **Hosted API:** Choose a [CivicPlus-hosted API](/process-automation/docs/api-hosting) 5. Add a **Dynamic List Label**![Creating a new dynamic list labeled 'Playgrounds' for form elements in an API.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Dynamic%20List%20Label%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=ASPGCG0G2bGxldSj2xZjlD6NYkRL5gGMg1Frsd%2FUe60%3D) > [!WARNING] > **Note**: > > This is the name the user building the form will see when they add it to a form so we recommend keeping this short but descriptive. 6. Choose the [Environment](/process-automation/docs/environments-overview) you wish to add the dynamic list to![Dynamic list screen with the Environment options selected.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Dynamic%20List%20Environment%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=lGV18d5AXcMWzZJ%2FQTT4vrFX9fQv%2BjcKYELSQMIdr4s%3D) 7. If you selected **Custom URL**, enter the link![Custom URL section highlighting Knowledge Management List URL.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Dynamic%20List%20Custom%20URL%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=j9ucaeRg4Iohy2j5RtYrtOe35n3YsirrmgsosBzY1ck%3D) 8. If you chose **Hosted API**, select an option from the dropdown ![Selection menu for Hosted API.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Dynamic%20Hosted%20API%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=Os5CpUYj1oFXhK5l77GdbWqfS2wgSWUq82NClYEJ0bE%3D) 9. Enable **Searchable via Autocomplete** if you would like to allow the Dynamic List to be assigned to an Autocomplete element that will query the server each time the user changes the search input ![The Searchable via Autocomplete toggle on the Dynamic List.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Dynamic%20List%20Search%20Autocomplete%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=sb2mguFGZQRkAPlEcbuPAtz8i8GJC8ZRpw%2FXtaRhsXI%3D) 1. Enter the **Querystring Parameter Name**![Input field for querying parameter name in an autocomplete element configuration.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Dynamic%20List%20Querystring%20Parameter%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=ty7ebUcYEGbh0ZV13y5LJ2p8kmC4y9jeV89D6kF7Yf0%3D) > [!WARNING] > **Note**: > > The user's input will be passed to the URL specified using a query string parameter to allow results to be filtered on your server. 10. Click **Save**![The Save button on the Dynamic List screen.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Save%20Dynamic%20List%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=4P0iW7FFOhCAl9uOZKsFbuWIiMxg5zERrPmLGhxKmFU%3D) 11. You can now add the dynamic list to an element on a form[![Form fields for playground selection with options for required and conditional display settings.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Dynamic%20List%20on%20Form%20Element%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A58%3A50Z&se=2026-11-22T13%3A58%3A50Z&sr=b&sp=r&sig=hv7MGhF13hTWGHNY6q%2F%2B6B63Q5mJvrY85%2BFGQ7f1m2g%3D)](/process-automation/docs/create-manage-forms) Application Programming Interface. A set of rules that allows programmers to develop software for a particular operating system without having to be completely familiar with that operating system. Uniform Resource Locator ## Related - [Create a Custom List](/create-a-custom-list.md) - [Create and Manage Forms](/create-and-manage-forms.md)