> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-components/ax-combobox.md).

# AX - Combobox

Lets users pick one or more options from a dropdown — single or multi-select, optionally searchable, with optional custom actions inside the dropdown.

## Overview

**AX - Combobox** is an Experience Cloud component that displays a configurable dropdown picker on Experience Sites pages.

Use it to let portal users choose from a fixed list of options or from values queried out of Salesforce — as a single-select or multi-select control, with optional search and custom actions rendered inside the dropdown. Configure the options, behavior, and styling in Experience Builder without code.

Perfect for filters, preference pickers, category selectors, or any form field where users choose from a set of options.

## Configuration

### Data Source

Choose where the combobox's options come from:

| Data Source Type | Description                                                          | Use Case                                         |
| ---------------- | -------------------------------------------------------------------- | ------------------------------------------------ |
| **Manual**       | Enter each option directly (label, value, secondary text, disabled). | Fixed, static option lists.                      |
| **Query**        | Auto-populate the options from a Salesforce object via a query.      | Options that should stay in sync with your data. |

### Properties

**Api Name** is a unique identifier used to reference the component, and **Label** is the field label shown above the combobox. **Field Level Help** adds a help-text tooltip beside the label.

**Default Value** sets the option(s) selected when the component first loads.

**Variant** controls the label layout: `standard`, `label-inline`, `label-stacked`, or `label-hidden`. **Placeholder** is the text shown before a selection is made.

**Dropdown Alignment** positions the dropdown relative to the input (`auto`, `left`, `center`, `right`, or a `bottom-*` variant), and **Dropdown Length** sets how many options are visible before scrolling (`5-items`, `7-items`, or `10-items`).

**Multi-Select** lets users choose more than one option, and **Keep Open On Select** keeps the dropdown open after each selection (useful with multi-select).

**Allow Search** adds a search box to filter options, and **Hide Options Until Search** shows options only once the user starts typing.

**Required** marks the field as mandatory, and **Disabled** prevents user interaction.

**Hide Clear Icon** removes the button that clears the current selection, and **Hide Selected Options** hides already-selected options from the dropdown list.

**Actions** define custom actions rendered inside the dropdown — each with a label, icon, position, and a click interaction, and options to keep them fixed, show them only during search, or show them when there are no results.

**Options** define the selectable items for a Manual data source — each with a label, value, optional secondary text, and a disabled state.

## Styling

Customize the combobox's appearance from the **Style** section of the property editor.

{% tabs %}
{% tab title="Margin" %}
Controls the outer spacing around the combobox.
{% endtab %}

{% tab title="Padding" %}
Controls the inner spacing of the combobox.
{% endtab %}

{% tab title="Size" %}
Controls the combobox's dimensions (Width / Height / Overflow).
{% endtab %}

{% tab title="Border" %}
Controls the border around the combobox (Color / Size / Style / Radius).
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-components/ax-combobox.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.