> 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`).
> - 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: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/sdk/host-modules/workspace/item-selector/introduction.md

## Article Content:

# About the Item Selector API

The Item Selector API lets you open item selection modals in the Wix dashboard, so Wix users can select items from a Wix service without leaving your extension. Use it to build flows where Wix users need to pick resources from their site data, such as choosing products to feature, blog posts to display, or contacts to target.

<blockquote class="important">

__Important:__
This API is only available in the dashboard. It requires the [workspace host to be initialized](https://dev.wix.com/docs/sdk/host-modules/workspace/introduction.md) and an updated version of the host initialization package to be installed.

</blockquote>

## Providers

A provider determines which Wix service populates the item selector modal. You specify the provider using a `providerKey` string when calling `openItemSelector()`. Each provider corresponds to a specific type of site data, such as products, contacts, or site pages.

Some providers require a specific Wix business solution to be installed on a site. For example, the Products provider requires [Wix Stores](https://www.wix.com/app-market/web-solution/wix-stores). Others are available on all Wix sites by default.

For the full list of supported providers and their requirements, see [Available providers](https://dev.wix.com/docs/sdk/host-modules/workspace/item-selector/open-item-selector.md#available-providers).

## Customizing the modal

When calling `openItemSelector()`, you can pass options to tailor the modal to your use case:

- **Limit selections**: Use `maxSelected` to set how many items a Wix user can select. Defaults to `1`.
- **Custom title and button text**: Use `title` and `primaryButtonText` to replace the default modal header and action button label with text that fits your context.
- **Pre-selected items**: Use `initialSelect` to pass an array of item IDs that appear as already selected when the modal opens. This is useful when editing an existing selection.

## Before you begin

It's important to note the following points before starting to code:

- Providers that depend on a Wix business solution won't work if that solution isn't installed on the site.
- This API can only be called from a [dashboard extension](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/about-dashboard-extensions.md) context.

## Terminology

- **Provider:** A Wix service that supplies the items shown in the selector modal, identified by a `providerKey` string.
- **Item:** A selectable entry in the modal, representing a resource from the provider, such as a product, blog post, or contact.

## See also

- [openItemSelector()](https://dev.wix.com/docs/sdk/host-modules/workspace/item-selector/open-item-selector.md#available-providers)