Opens the Wix Media Manager for the selected component, letting a Wix user choose images, videos, or other media.
params accepts one of the following shapes:
For more information on this choice, see Picker arguments.
Connects the picker to a manifest data field, so the selected media saves to it automatically.
| Name | Type | Description |
|---|---|---|
dataItemKey | string | Key of a data field with dataType: 'image' or 'video' in the manifest. The editor reads the current value, opens the media manager, and saves the selection back to this field automatically. |
Opens the media manager without connecting it to the manifest, so you decide what to do with the selected media.
| Name | Type | Description |
|---|---|---|
isMultiSelect | boolean | Whether a Wix user can select more than one media item. |
category | string | Restricts the media manager to a specific category, such as 'image', 'WELCOME_SCREEN', or 'SOCIAL_ICONS'. |
Promise<MediaItem[] | undefined>
An array of the selected media items, or undefined if the Wix user closes the media manager without selecting anything.
Last updated: 8 September 2026