---
title: "Create a Dependent Dropdown on a List"
slug: "create-dependent-dropdown-on-list"
description: "Learn to set up dependent dropdowns in Lists with our configuration Metric wizard, ensuring seamless connections between your dropdown Properties."
tags: ["blocks", "Configuration Metric", "List Properties", "Modeling Formulas"]
updated: 2025-11-25T15:33:59Z
published: 2025-11-25T15:33:59Z
---

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

# Create a Dependent Dropdown on a List

Dependent dropdowns allow Dimension Properties to be connected together, so that when an input is made in one Property, only relevant Items are suggested in the others.

In the example below, the **Country** Property has been connected to the **User******Property. As the User “Karl” belongs to “Germany”, the dependent dropdown suggests only “Germany” for Karl’s Country.

![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/image(253).png)

> [!WARNING]
> **⚠️****Important**
> 
> To perform this task, you need the **Can Configure Block** permission.

### Before you begin

Setting up dependent dropdowns on a List is a two-step process. The first step is to establish a configuration Metric that shows the connection between the dropdowns. The second step is to map the Dimensions to the location where you’ll use the dropdowns. You can now do both steps in the same process in our configuration Metric wizard.

- When you set up a configuration Metric, it must be of Boolean type.
- The Metric's structure must contain the exact same Dimensions as the Properties you wish to connect.
- The Metric needs to establish a relationship with a minimum of two Dimensions.
- Shared Metrics with these criteria can be used as configuration Metric.
- The Metric's structure must match the Dimensions that are used as dropdowns in List Properties.
- After you set up the configuration Metric, it can be used for multiple connections.
- If a Property is mapped once, it cannot be mapped again.

### Create a Dependent Dropdown on a List

1. In your Application, open the List where you need to set up a dependent dropdown.
2. Click the **Settings** icon.
3. Click **Dependent dropdowns**, and then click **Connect Properties.**
4. From the menu, select the Properties you want to connect. These Properties have the dropdown items linked to each other. These can only be Properties of type Dimension, and you need to select at least two Properties of different Dimensions.
5. Do one of the following:
  1. **Use an existing configuration Metric.** If a matching Configuration Metric already exists, select it from the menu.
  2. **Create a new configuration Metric.** If no configuration Metric exists, you’re prompted to create a new one. We explain how to do this using the wizard below.
6. *(Optional)*In the Dependent dropdown section of your List settings, you can review, edit, and delete your dependent dropdown.
7. *(Optional)*Open the new configuration Metric in Block Explorer to view the linked connections for each Property.

### Create a New Configuration Metric​​​​​​​

When you create a new configuration Metric, the configuration wizard opens a Metric in Boolean format. It also displays the Dimensions used in your selected Properties in rows or columns, and pages.

To set up the new configuration Metric:

1. In the Connect configuration pane, click **Create new configuration**.
2. In the wizard, do one of the following:
  1. Write a formula in the **Formula**field to define the relationship between the Dimensions you want to connect. The formula should return `TRUE `for the combinations of Dimension Items that should be linked (i.e. when an option should be suggested in the dependent dropdown), and `FALSE `otherwise.

For example, if you want to link Countries to Regions, your formula could look like:

`Country.Region = Region`

This formula returns `TRUE `when the Country belongs to the selected Region.

You can also use `IF` statements or other logical conditions such as: `ISDEFINED(Country.Region)[BY: -> Country.Region]` The key is that the formula must use the same Dimensions as the Properties you are connecting.
  2. Select the checkboxes to specify the linked connections that you need.
3. Click **Save Configuration**.
4. Enter a name for your new configuration Metric and click **Save configuration**.

### ​​​​​Editing Dropdown Connections

After a connection is established, you can continue to fill or adjust the data in the Metric that was used to configure the connection. It will not affect any inputs that were used in the dropdowns.

However, if the configuration Metric dimensions are adjusted or the data type changes, this breaks the connection.