> For the complete documentation index, see [llms.txt](https://appeggiohelp.gitbook.io/appeggio-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://appeggiohelp.gitbook.io/appeggio-help/forms/selects.md).

# Selects

Adding and styling selects.

## What Are Selects? <a href="#what-are-selects" id="what-are-selects"></a>

A Select is used to pick a value from a list of options.

They are useful for providing users with a predefined set of options to choose from. Users can quickly scan the list and choose the option that best fits their needs without the need to type out a response. They are also great for consistency, removing the need to analyze free-form responses.

{% hint style="success" %}
**Location in the Parts Library:** Base Parts > Data Input > Select
{% endhint %}

<figure><img src="https://2904013950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNFsr0mZTFrCZvHflb9%2Fuploads%2FXf1IvjjwAFv6Wyq1sNv7%2FWhatIsASelect.png?alt=media&amp;token=0db9b34d-1795-4bc8-85b7-857bcb621ddb" alt=""><figcaption><p>Example of a Select</p></figcaption></figure>

## The Components in A Select

The Select part consists of placeholder text (which might give an instruction such as 'select an option', or 'choose from the list'), and two or more Select items that drop down when the Select is expanded. There may also be a label above or below the Select part.

## Editing Selects

Suppose there is a label above the Select. In that case, it's easily editable by selecting the text within the label, and editing as you would normally edit [text](/appeggio-help/frequently-used-parts/text.md) - by going to 'Text' in the property panel on the right and keying in your new value.

To edit the placeholder text within the Select box, select the text, then go to 'Text' in the property panel on the right and key in your new value. Placeholder text is usually an instruction for what is needed in the Select.&#x20;

Your Select will need to be given an ID, which is an identifier for your select group. For example, if your Select is about choosing your favorite type of pet, then you might give it an identifier such as FavoritePet, or something that indicates to you what the Select is about. When you give your Select an ID, that ID automatically gives the select a State. You can see this when you click on the State Model property in the right property panel.&#x20;

<figure><img src="https://2904013950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNFsr0mZTFrCZvHflb9%2Fuploads%2Fmj8JALvIiBhJbGxU5mn2%2FSelectStateModel.png?alt=media&amp;token=ca6c85ff-6b8a-43e5-9b67-bf7ef455c030" alt=""><figcaption><p>Select Property - Setting the State</p></figcaption></figure>

### Editing and Adding Select Items

To edit the dropdown options, go to the Select Item.&#x20;

First, we want to change the text within the Select item. In the property editor on the right, go to Title > Value Set, and enter the text for your dropdown item. That is the text that will appear in the dropdown list.&#x20;

Now the value needs to be set for the Select.&#x20;

In the property editor on the right, go to Value > Value Set, and enter the value for the item. This is the value that will appear in your database regarding the option that was chosen. The value could be the same as the title, or similar. &#x20;

In the example below, you'll see the placeholder text of the select being updated; and the titles and values of the Select items.

You'll also see a Select item being changed, with a new icon being added; and a Select item being duplicated and edited to add another option to the list.&#x20;

Press play to watch the short video:

{% embed url="<https://www.loom.com/share/2aa157b18c764e04ab724057d4c64410?hideEmbedTopBar=true&sid=8aab34a6-6bc9-4323-a711-bf69b1e3265a>" %}
Updaing Placeholder Text, Titles and Values of Select Items
{% endembed %}

## Styling Selects <a href="#editing-selects" id="editing-selects"></a>

[Borders](/appeggio-help/customising-and-formatting/borders.md), [shadow](/appeggio-help/customising-and-formatting/shadow.md), [rounding](/appeggio-help/customising-and-formatting/rounding.md), and [opacity](/appeggio-help/customising-and-formatting/opacity.md), can be amended using the property editor on the right, once the Select part has been selected.

### **Changing the Colors of Selects** <a href="#changing-the-colors-of-radio-buttons" id="changing-the-colors-of-radio-buttons"></a>

Selects have more [color](https://appeggiohelp.gitbook.io/appeggio-help/customising-and-formatting/colors-and-themes) properties than most other parts. The background and foreground colors can be set.

You can also change the colors of Selects in an active state, when focused, and on hover. These are done the same way for foreground and background color.

To change the color when the Select is being hovered, select the Select part and open the 'Colors on Hover' editor on the right. Now you can set your preferred background and foreground color combination to signify that the Select is being hovered.

The 'Color on Focus' editor on the right refers to the color of the Select after it has been clicked, or if the user tabs to the Select.

The 'Color on Active' editor on the right refers to the color of the Select when it is active (the moment it is clicked).

The background colors of Input/Text Input Areas can be a [color gradient](https://appeggiohelp.gitbook.io/appeggio-help/customising-and-formatting/color-gradients).

### Sizing the Select and the Menu Dropdown

The Select can be sized using the preset size, or by specifying the width and the height. In addition, you can set the width and the height of the menu dropdown in the sizing editor. In each case, sizes can be set based on device size.

<figure><img src="https://2904013950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNFsr0mZTFrCZvHflb9%2Fuploads%2FcbZFPxncmyDZZz2nf1aX%2FSelectSizing.png?alt=media&amp;token=ae784690-2ba2-4911-b6bc-a4accc830a0b" alt=""><figcaption><p>Sizing the Select Part</p></figcaption></figure>

Here is an example of setting the menu height for an extra small screen, and a medium screen. The XS screen has been set to a menu height of 150, which results in the menu scrolling to accommodate the menu:

<figure><img src="https://2904013950-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNFsr0mZTFrCZvHflb9%2Fuploads%2Fisf3HwOsstk8DTik2bch%2FSelectMenuSize.gif?alt=media&amp;token=30114969-c447-4a60-af0e-90c7c3aae9fd" alt=""><figcaption><p>Sizing the Menu of the Select Part</p></figcaption></figure>

## Related Information <a href="#related-information" id="related-information"></a>

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:orange;">Icons</mark></td><td></td><td></td><td><a href="/appeggio-help/frequently-used-parts/icons.md">Icons</a></td></tr><tr><td><mark style="color:orange;">Avatars</mark></td><td></td><td></td><td><a href="/appeggio-help/base-parts/display/avatars-and-avatar-groups.md">Avatars and avatar groups</a></td></tr><tr><td><mark style="color:orange;">Text</mark></td><td></td><td></td><td><a href="/appeggio-help/frequently-used-parts/text.md">Text</a></td></tr><tr><td><mark style="color:orange;">Customizing and formatting</mark></td><td></td><td></td><td><a href="/appeggio-help/customising-and-formatting.md">Customizing and formatting</a></td></tr></tbody></table>
