> 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/introduction.md

## Article Content:

# About the Workspace API

The Workspace API provides methods for interacting with the Wix dashboard and editor. Each method supports a specific context: the dashboard, editor, or both. Check the documentation for each method to see where you can use it.

## Setup

@package_metadata:@wix/workspace

To use the Workspace API, install the `@wix/workspace` package.

### Install the package

Follow the installation instructions for your development environment.

| Development environment    | Installation method |
| -------------------------- | ------------------- |
| Blocks apps                | Use the [package manager](https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-in-the-editor.md). |
| CLI and self-hosted apps   | Run `npm install @wix/workspace` or `yarn add @wix/workspace`. |

### Import the package

To import the package in your code:

```js
import { workspace } from "@wix/workspace";
```

### Usage

To use the package, follow the instructions below based on your development environment.

#### Wix sites and Wix-hosted apps

Import the relevant submodule in your code and call its methods directly.

```js
import { itemSelector } from "@wix/workspace";

const result = await itemSelector.openItemSelector("<providerKey>");
```

#### Self-hosted apps

Create a client using the Workspace APIs.

```js
import { workspace } from '@wix/workspace';
import { itemSelector } from '@wix/workspace';
import { createClient } from '@wix/sdk';

const client = createClient({
  host: workspace.host(),
  auth: workspace.auth(),
  modules: {
    itemSelector,
  },
});
```

Then use the client to call the module's methods.

```js
const result = await client.itemSelector.openItemSelector("<providerKey>");
```