> For the complete documentation index, see [llms.txt](https://conusyntax.gitbook.io/products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://conusyntax.gitbook.io/products/widget-blueprints/wbp_dropdownbutton.md).

# WBP\_DropdownButton

Allows players to select from a predefined list of options.

#### Behavior

Each **Dropdown Button** is driven by a **Gameplay Tag** (e.g., `CharacterCreator.Gender`, `CharacterCreator.Race`, or `CharacterCreator.Groom.Hairstyle`). This tag serves two primary purposes:

1. **Automatic Initialization**: The dropdown reads the tag to determine which list of options to generate.
2. **Logic Execution**: It defines which internal function to trigger when the player selects an option from the list.

<figure><img src="https://1883754984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EcXMpvBDtWhtztAbvO1%2Fuploads%2F2hyRN5HocIKcmcwGf22G%2FDropdown%20Button%20-%20Behavior.jpg?alt=media&amp;token=8f5a1bfa-c06b-43d9-896a-1df108469ad8" alt=""><figcaption></figcaption></figure>

#### Initialization

The widget is set up in the Initialize **Dropdown Button** collapsed graph. During this phase, the system identifies the assigned Gameplay Tag and populates the dropdown with the corresponding data:

* **Gender**: Populates the list with Gender options.
* **Race**: Populates the list with Race options.
* **Hairstyle**: Populates the list with available Groom Assets.

<figure><img src="https://1883754984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EcXMpvBDtWhtztAbvO1%2Fuploads%2FWrhxFxJbTo2gTKCx1QNP%2FDropdown%20Button%20-%20Initialization.jpg?alt=media&amp;token=fcdbbfb6-49d0-405c-91d9-483284e91fdc" alt=""><figcaption></figcaption></figure>

#### Using the Dropdown Button

1. Place a **WBP\_DropdownButton** widget.
2. In the **Details**, go to **Button** ➞ **Attributes**.
3. **Set** **Gameplay Tag**: Assign the Gameplay Tag that corresponds to the data you want this dropdown to control.

<figure><img src="https://1883754984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EcXMpvBDtWhtztAbvO1%2Fuploads%2FOmSJoipt2IqyOFhWBnTA%2FWBP_DropdownButton%20-%201.png?alt=media&amp;token=f2f69345-ffdd-4412-9d10-4b0a509d5e09" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
If no Gameplay Tag is assigned, the dropdown will not be able to fetch data and will fail to function correctly.
{% endhint %}

### Available Functions

The blueprint contains a library of functions to support various data types. Ensure your Gameplay Tag is connected to the corresponding nodes in the **WBP\_DropdownButton** graph:

#### Set Functions (Execution)

These apply the selected data to the Character.

<figure><img src="https://1883754984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EcXMpvBDtWhtztAbvO1%2Fuploads%2Fq3niPamzf4nigy2kWxUW%2FDropdown%20Button%20-%20Set%20Functions.jpg?alt=media&amp;token=c9e1b83d-1028-47c2-996c-aabf6392c4f5" alt=""><figcaption></figcaption></figure>

#### Initialize Functions (Setup)

These define what appears in the list.

<figure><img src="https://1883754984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6EcXMpvBDtWhtztAbvO1%2Fuploads%2Fhzc2OiTiYFncCZ7QEgH5%2FDropdown%20Button%20-%20Initialize%20Functions.jpg?alt=media&amp;token=95262c47-ac01-4d5f-9df0-560fd0b443e7" alt=""><figcaption></figcaption></figure>
