# Enable post-install actions and configurations

Support additional configurations that occur after app installation.

After a user installs your app, you might require them to perform additional actions or configurations. For example, your app might require that the user supply separate credentials to access an external service. Stripe Apps refer to these additional steps as *post-install actions*. You can configure one of several types of post-install actions:

- Within the app itself, using a [SettingsView](https://docs.stripe.com/stripe-apps/components/settingsview.md) component
- Externally, using a link to an external website

If you don’t define a post-install action, the Dashboard displays the app after installation.
 (See full diagram at https://docs.stripe.com/stripe-apps/post-install-actions)
## Add a post-install action

To add a post-install action:

1. Open your [app manifest](https://docs.stripe.com/stripe-apps/reference/app-manifest.md) file.

1. Add a new field, `post_install_action`.

   ```json
   {
     "id": "com.invoicing.[YOUR_APP]",
     "version": "1.2.3",
     "name": "[YOUR APP] Shipment Invoicing",
     "icon": "./[YOUR_APP]_icon_32.png",
     "permissions": [],
     "app_backend": {},
     "ui_extension": {},"post_install_action": {}
   }
   ```

1. Add the [configuration option](https://docs.stripe.com/stripe-apps/post-install-actions.md#configuration-options) for the `post_install_action` that meets the needs of your application setup.

1. [Upload](https://docs.stripe.com/stripe-apps/upload-install-app.md) your app to Stripe.

1. [Make a new release](https://docs.stripe.com/stripe-apps/versions-and-releases.md) of your app.

1. [Publish](https://docs.stripe.com/stripe-apps/publish-app.md) your app to the marketplace.

## Configuration options 

Stripe Apps support the following post-install actions:

- [Link to app](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-app)
- [Link to onboarding](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-onboarding)
- [Link to settings](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-settings)
- [Link to external URL](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-external)

### Link to app (default) 

The default action after the user installs your app is to redirect that user to your application interface, if one is available.
![Post-install screen with a link to view an app](https://b.stripecdn.com/docs-statics-srv/assets/app.09cbbc38c50cfef0a9aaf9a92f8d1d0e.png)

This behavior requires no additional configuration to implement.

### Link to onboarding 

To direct your user to complete setup tasks before using your app, launch the [onboarding flow](https://docs.stripe.com/stripe-apps/patterns/onboarding-experience.md) immediately after app installation. To enable this flow, update the `post_install_action` parameter in your app manifest file.

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "onboarding"
  }
}
```

### Link to external URL 

If you need the user to visit an external site to configure their app, update the `post_install_action` parameter in your app manifest file as follows:

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "external",
    "url": "https://[YOUR-URL]"
  }
}
```

Replace `[YOUR-URL]` with the URL to the external site.

When the user installs your app, the application displays a button that redirects the user to the URL specified in the app manifest file.

This URL includes an `account_id` query string parameter that you can use to identify the user. For example:

```
https://www.company.com/marketplace/stripe?account_id=12345
```
![Post-install screen with an external link](https://b.stripecdn.com/docs-statics-srv/assets/external.565e55096589e7c7580bc5d534c1ace1.png)

### Link to settings

If your app contains a [SettingsView](https://docs.stripe.com/stripe-apps/components/settingsview.md) component, you can configure a `post_install_action` to open it after installation. To enable this action, update your app manifest file as follows:

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "settings"
  }
}
```

When the user installs your app, the application displays a button that redirects them to your applications SettingsView component.
![Post-install screen with a link to view settings](https://b.stripecdn.com/docs-statics-srv/assets/settings.e6bc859871bc657c25d353055497c8ee.png)