> Note:
> This is a legacy API. Use the latest version of [`Share`](/docs/api/app-bridge-library/apis/share) instead.

The `Share` action allows you to invoke the "share sheet" to share content from your embedded app on an iOS or Android device.

<img alt="A simplified drawing of a smartphone. on the phone's screen is a graphic of an ios share sheet." src="/assets/apps/tools/app-bridge-sharing.png" style="display: block; width: 100%; max-width: 524px">

## Requirements

These actions require the following app versions:

- **Shopify iOS v8.22.0** or above
- **Shopify Android v8.25.0** or above
- **Point of Sale iOS v5.29.0** or above
- **Point of Sale Android v3.24.0** or above

## Setup

Create an app and import the `Share` module from `@shopify/app-bridge/actions`. Note that we'll be referring to this sample application throughout the examples below.

> Note
> In the following example, `config` is a valid App Bridge configuration object. Learn more about [configuring App Bridge](/docs/api/app-bridge/previous-versions/app-bridge-from-npm/app-setup#initialize-shopify-app-bridge-in-your-app).


```js
import createApp from '@shopify/app-bridge';
import {Group, Share} from '@shopify/app-bridge/actions';

var app = createApp(config);

var share = Share.create(app);
```

## Share Close action

<table>
  <tr>
    <th>Group</th><td>Share</td>
  </tr>
  <tr>
    <th>Action</th><td>CLOSE</td>
  </tr>
  <tr>
    <th>Action Type</th><td>APP::SHARE::CLOSE</td>
  </tr>
  <tr>
    <th>Description</th><td>Dispatches after closing the Share Sheet.</td>
  </tr>
</table>

The `Share` action lets you share content from your app to any third-party app on the user's device, as long as the app supports the payload type. Some apps only support text and some support URLs and text.

## Subscribe to Share Close:

```js
share.subscribe(Share.Action.CLOSE, function (payload) {
  // The payload will contain `success` as its only property. This is set to `true` upon a successful share and set to `false` if the action is canceled.
});
```

### Response

<table>
  <thead>
    <tr>
      <th>Key</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>success</code></td>
      <td>Boolean</td>
      <td>Whether the share was successful or canceled.</td>
    </tr>
  </tbody>
</table>

## Share Open action

<table>
  <tr>
    <th>Group</th><td>Share</td>
  </tr>
  <tr>
    <th>Action</th><td>SHOW</td>
  </tr>
  <tr>
    <th>Action Type</th><td>APP::SHARE::SHOW</td>
  </tr>
  <tr>
    <th>Description</th><td>Opens a Share Sheet that allows you to share content with other apps.</td>
  </tr>
</table>

```js
share.dispatch(Share.Action.SHOW, {
  text: 'Hey check this out!',
  url: 'https://www.reallyawesomesite.com',
});
```

> Note: In Debug Mode, `text` and `url` are optional but at least one needs to be included in the payload. If neither are present then an `APP::ERROR::INVALID_PAYLOAD` will be thrown or sent to an Error subscriber. However, in Production Mode this will silently fail.

### Request

<table>
  <thead>
    <tr>
      <th>Key</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>text</code></td>
      <td>String?</td>
      <td>The text to share.</td>
    </tr>
    <tr>
      <td><code>url</code></td>
      <td>String?</td>
      <td>The URL to share.</td>
    </tr>
  </tbody>
</table>