# App viewport

Show a view from an installed App.

App viewport renders a view from an installed app. App viewport is a private preview component that requires using preview versions of Stripe SDKs. Read more about [private preview components](https://docs.stripe.com/connect/supported-embedded-components.md#preview-components).

For full integration details, see the [Embedded Stripe Apps integration guide](https://docs.stripe.com/stripe-apps/embedded-apps.md).

### Create an Account Session 

When [creating an Account Session](https://docs.stripe.com/api/account_sessions/create.md), enable the App install component by specifying `app_viewport` in the `components` parameter. You must enable the app you want to render by specifying the `features` parameter under `allowed_apps`.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-07-29.preview; embedded_connect_beta=v2;" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[app_viewport][enabled]=true" \
  -d "components[app_viewport][features][allowed_apps][]=APP_ID"
```

After creating the account session and [initializing ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), you can render the App viewport component in the front end. The view doesn’t render if the app isn’t installed:

#### JavaScript

```js
const appViewport = stripeConnectInstance.create('app-viewport');
appViewport.setApp('{{APP_ID}}');
appViewport.setAppData({userId: '{{PLATFORM_USER_ID}}'});
container.appendChild(appViewport);
```

This embedded component supports the following parameters:

#### HTML + JS

| Method | Type | Description |
| --- | --- | --- |
| `setApp` | `string` | Sets the ID of the App your connected account can render. See available apps in the  [Embedded Stripe Apps integration guide](https://docs.stripe.com/stripe-apps/embedded-apps.md#app-select). |
| `setAppData` | `Record<String, String>` | Sets data pertaining to your platform consumed by the App. |

#### React

| React prop | Type | Description |
| --- | --- | --- |
| `app` | `string` | The ID of the App your connected account can render. See [available apps](https://docs.stripe.com/stripe-apps/embedded-apps.md#app-select). |
| `appData` | `Record<String, String>` | Data pertaining to your platform consumed by the App. |

You can integrate our sample app (set `APP_ID` to `stripe.app-explorer`), which we’ve pre-approved for embedding on your platform.

Read more about [App install ](https://docs.stripe.com/connect/supported-embedded-components/app-install.md).

## Request early access  (Private preview)

Sign in to request access to this Connect embedded component in preview.

If you don’t have a Stripe account, you can [register now](https://dashboard.stripe.com/register).