> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: AddressInputItem Component

## Article: AddressInputItem Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/form/address-input-item-component.md

## Article Content:

# AddressInputItem

_Components/Form/AddressInput/AddressInputItem_

Interactive docs page: <https://wix-pages.com/design-system-documentation/#/component/addressinputitem>

## Overview

```jsx
<StorybookComponents.Stack flexDirection="column" width="50%">
  <AddressInputItem
    mainLabel="Work"
    secondaryLabel="512 4th St NE, Montgomery, MN, 56069"
  />
</StorybookComponents.Stack>;
```

Address Input Item is an internal component that displays address list item in a dropdown selection. It's mainly used as a part of the `<AddressInput/>` component.

### Do

- Use it to represent address selection items.

### Don't

- Don't use it to represent an option of any select component. Use `<ListItemSelect/>` instead.

### Feature examples

#### Structure

The component consists of two labels accompanied by a location icon:\
 - \`mainLabel\` - use it to display a main keywords for search suggestions;\
 - \`secondaryLabel\` - use it for secondary address data, such as country or region.

```jsx
<AddressInputItem mainLabel="Main Label" secondaryLabel="Secondary Label" />;
```

#### States

Control the state of a component with:\
 - \`highlighted\` - use it to mark a suggested value\
 - \`selected\` use it to mark an active selection\
 - \`disabled\` - use it to mark an unavailable item

```jsx
<StorybookComponents.Stack flexDirection="column">
  <AddressInputItem mainLabel="Highlighted" highlighted />
  <AddressInputItem mainLabel="Selected" selected />
  <AddressInputItem mainLabel="Disabled" disabled />
</StorybookComponents.Stack>;
```

#### Layout

Control option layout with optionLayout prop. It supports 2 values:\
 - \`single-line\` (default) - use in all common cases\
 - \`double-line\` - use for addresses that display more data (include country, region, post code and more)

```jsx
<StorybookComponents.Stack flexDirection="column">
  <AddressInputItem
    mainLabel="Single Line"
    secondaryLabel="Layout"
    optionLayout="single-line"
  />
  <AddressInputItem
    mainLabel="Double Line"
    secondaryLabel="Layout"
    optionLayout="double-line"
  />
</StorybookComponents.Stack>;
```

#### Affix

Support option value with additional information added to \`prefix\` and \`suffix\` props. Props accept text, icons and even badges.\
\
\`prefix\` area by default is filled with a location icon to indicate that this is an address list item.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <AddressInputItem
    mainLabel="Address"
    secondaryLabel="With a default layout"
  />
  <AddressInputItem
    mainLabel="Address"
    secondaryLabel="With a removed prefix"
    prefix={false}
  />
  <AddressInputItem
    mainLabel="Address"
    secondaryLabel="With a custom prefix and suffix"
    suffix="Suffix"
    prefix={<Icons.Toolbox />}
  />
</StorybookComponents.Stack>;
```

### Common use case examples

#### List item builders

Use it as a list item to build custom address input suggestions.

```jsx
() => {
  const options = [
    listItemSectionBuilder({
      id: 'saved-addresses',
      title: 'Saved Addresses',
      type: 'title',
    }),
    addressInputItemBuilder({
      id: 0,
      mainLabel: '2818 Saint Patrick Pl, Helena, 35080',
      secondaryLabel: 'Alabama, USA ',
      prefix: <Icons.Toolbox />,
      suffix: '2km away',
      optionLayout: 'double-line',
    }),
    addressInputItemBuilder({
      id: 1,
      mainLabel: '512 4th St NE, Montgomery, 56069',
      secondaryLabel: 'Minnesota, USA',
      prefix: <Icons.Home />,
      suffix: '34km away',
      optionLayout: 'double-line',
    }),
    listItemSectionBuilder({
      id: 'divider',
      type: 'divider',
    }),
    addressInputItemBuilder({
      id: 2,
      mainLabel: '3499  Henry Ford Avenue, Sallisaw, 74955',
      secondaryLabel: 'Oklahoma, USA ',
      optionLayout: 'double-line',
    }),
    addressInputItemBuilder({
      id: 3,
      mainLabel: '1382  Goosetown Drive, Newland, 28657',
      secondaryLabel: 'North Carolina, USA',
      optionLayout: 'double-line',
    }),
    addressInputItemBuilder({
      id: 4,
      mainLabel: '2887  Eagle Drive, Flat Rock, 48134',
      secondaryLabel: 'Michigan, USA',
      optionLayout: 'double-line',
    }),
  ];

  return <AddressInput options={options} />;
};
```

## Code

```jsx
import { AddressInputItem } from '@wix/design-system';
```

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `disabled` | `boolean` | — | Specifies whether option is disabled. |
| `highlighted` | `boolean` | — | Specifies whether option is highlighted. |
| `mainLabel` | `string` | — | Sets the main label of an option. This label is a primary part that is matched to a search term or keyword. |
| `onClick` | `MouseEventHandler` | — | Defines a callback function which is called every time option is clicked. |
| `optionLayout` | `"single-line" \| "double-line"` | `'single-line'` | Sets the layout of mainLabel and secondaryLabel. Labels can be either side by side or stacked vertically. |
| `prefix` | `ReactNode` | — | Pass a component you want to show as the prefix of the input, e.g., text, icon. |
| `secondaryLabel` | `string` | — | Sets the additional information of an address. Usually contains a region or a country. |
| `selected` | `boolean` | — | Specifies whether the option is selected. |
| `size` | `"small" \| "medium"` | — | Controls the size of the labels. When rendered inside `<AddressInput/>`, it is set from the input size. Default value: `medium`. |
| `suffix` | `ReactNode` | — | Pass a component you want to show as the suffix of the input, e.g., text, icon, button. |

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { AddressInputItemUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { AddressInputItemTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { AddressInputItemTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { AddressInputItemTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| Method | Description |
| --- | --- |
| `getPrefix` | Get prefix |
| `getMainLabelText` | Get main label Text |
| `getSecondaryLabelText` | Get secondary label Text |
| `getSuffix` | Get suffix |
| `exists` | Checks whether the component found with the given data hook. |
| `element` | Gets the component root element. |
| `click` | Clicks on the component root element. |
| `base` | Returns UniDriver for the base element. |

## Changelog

- **1.340.0** (2026-10-21) — maintenance release, no component-specific changes
- **1.339.0** (2026-10-19) — maintenance release, no component-specific changes
- **1.338.0** (2026-10-15) — maintenance release, no component-specific changes
- **1.331.0** (2026-10-01) — maintenance release, no component-specific changes
- **1.330.0** (2026-09-28) — maintenance release, no component-specific changes
- **1.329.0** (2026-09-24) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.323.0** (2026-09-10) — maintenance release, no component-specific changes
- **1.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.292.0** (2026-06-22) — maintenance release, no component-specific changes
- **1.291.0** (2026-06-19) — maintenance release, no component-specific changes
- **1.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.254.0** (2026-02-03) — maintenance release, no component-specific changes
- **1.242.0** (2025-12-19) — maintenance release, no component-specific changes
- **1.187.0** (2025-05-07) — maintenance release, no component-specific changes
- **1.165.0** (2025-02-27) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes