# Update Slack App

Copy Risotto's current manifest into your custom Slack app, so it gets the scopes and settings that new features need.

> **Info:** This guide is only for organizations that connected Slack with a custom Slack
> app (see [Custom Slack App Setup](https://www.tryrisotto.com/docs/guides/initial/slack-app-custom)). If
> you installed the Marketplace app, you don't update it yourself, and the
> **Update manifest...** option does not show.

A custom Slack app keeps the manifest it had when you created it. When Risotto adds a feature that needs new Slack scopes or settings, such as Slack ticket lists, forms, or an install across a whole Enterprise Grid organization, copy Risotto's current manifest into your app.

The manifest replaces your app's whole configuration in Slack. It keeps your bot's current name, but other changes that you made to the app in Slack are overwritten.

1. **Open Slack's integration page**

   In the Risotto dashboard, go to **Settings > Integrations** and click the **Slack** card.

   If you run more than one Risotto organization, each has its own Slack app. Open the dashboard of the organization whose app you want to update.

2. **Open Update manifest**

   On the **Chat app** card, click **Connected**, then click **Update manifest...**.

   *Product example: Slack's page in the Risotto dashboard with a custom app, the Connected menu open on Update manifest....*

3. **Copy the manifest**

   The **Update Slack App Manifest** dialog opens. Read the **Before you update** warning, then click the copy button on the manifest.

   *Product example: The Update Slack App Manifest dialog in the Risotto dashboard, with the manifest's copy button.*

4. **Open your app's App Manifest page**

   In the dialog, click **Slack Apps**. Slack's settings for your app open. Click
   **App Manifest** in the sidebar.

5. **Replace the manifest and save**

   Replace the contents of the manifest editor with the JSON that you copied, then click **Save Changes**.

   *Product example: Your Slack app's App Manifest page, in outline, with Save Changes.*

6. **Verify the request URL**

   If Slack shows that `settings.event_subscriptions.request_url` is not verified, click **Click here to verify**. The URL is Risotto's events URL for your organization, `https://api.tryrisotto.com/org/<your org ID>/slack/events`.

   *Product example: Your Slack app's App Manifest page, in outline, with the request URL notice and Click here to verify.*

7. **Reinstall the app if Slack asks**

   If Slack says that a reinstall is needed, for example because the manifest
   adds scopes, click **Install App** in the sidebar, then click **Reinstall to
   Workspace**.

8. **Test**

   Send a test request to Risotto in Slack and check that it replies.

Source: https://www.tryrisotto.com/docs/guides/update-slack-app
