Skip to main content

Install Apps and Bots

Browse the App Store and install, update, or remove Apps and Bots in your community.

note

Installing and managing Apps and Bots requires Root on desktop. Once installed into a community, Apps and Bots can be used on Root desktop and mobile.

Required permissions
  • Manage Appsinstall, update, and remove Apps and Bots

What to expect​

Installing an App creates a dedicated channel in your community. Installing a Bot adds it to your community without a channel. During installation, you assign roles to give the App or Bot the permissions it needs.

When you install an App, it creates a dedicated channel in your community. You'll name the channel and configure who can see it. Some Apps also have global settings (configuration specific to that App, like choosing which roles can create content or who can vote). If an App has required settings, you'll need to fill them in before the installation can finish.

After installation, you'll also want to choose which channels the App or Bot operates in (that is, which channels it can see). See Add Apps and Bots to channels for details. You can also adjust settings at any time. See Configure App and Bot settings.

Install an App​

note

Apps can also be installed from Community Settings. Under Management, select Apps, then select Add App. When prompted, select a channel group, then follow the same steps from step 4.

  1. Right-click a channel group in the sidebar (or select the + icon that appears when you hover over it).
  2. Select Create channel.
  3. Under channel type, select App channel.
  4. Select Choose app to open the App Store.
  5. Browse the available Apps or use the search bar to find a specific one. Each card shows the App's name, developer, category, and a short description. All Apps and Bots are free for a limited time.
  6. Select an App card to view its details, including the description, screenshots, and developer information.
  7. Select Select to choose the App.
  8. Back in the Create Channel dialog, configure the App:
    • General: Enter a channel name and optional description.
    • Permissions: Control who can see the App channel. By default, permissions sync with the parent channel group. Turn off Sync Permissions to customize.
    • App Global Settings: Configure the App's settings. Required fields are marked with an asterisk (*). This tab only appears for Apps that have global settings.
  9. Select Create.
  10. In the Assign roles to [App name] dialog, select + to assign roles to the App.
  11. Select Done.

The App appears as a new channel in the channel group you selected.

Install a Bot​

  1. Select the community image in the sidebar.
  2. Select Community settings.
  3. Under Management, select Apps.
  4. Select Browse the bot store.
  5. Browse the available Bots or use the search bar to find a specific one.
  6. Select a Bot card to view its details.
  7. Select Install.
  8. In the Install bot dialog, select Install to confirm.
  9. In the Assign roles to [Bot name] dialog, select + to assign roles to the Bot.
  10. Select Done.

Bots run in the background without a channel.

Update an App or Bot​

  1. Select the community image in the sidebar.
  2. Select Community settings.
  3. Under Management, select Apps or Bots.
  4. Select the App or Bot to open its management panel. Apps with a newer version available show an Update available badge.
  5. Select Update.
  6. If the update requires new settings, fill in the required fields before confirming.

Automatic updates​

When a new version is released, you have 24 hours to update manually. After 24 hours, the update is applied automatically. The App channel is temporarily unavailable while the update is being applied.

Suspended Apps​

If an automatic update can't proceed because new settings are required, the App is suspended instead of updated. A red APP SUSPENDED banner appears at the top of the General tab.

  1. Select Review & Update.
  2. Fill in the required settings.
  3. Confirm the update.

Remove an App or Bot​

  1. Select the community image in the sidebar.
  2. Select Community settings.
  3. Under Management, select Apps or Bots.
  4. Select the App or Bot to open its management panel.
  5. In the General tab, scroll to the Remove section.
  6. Select Delete.
  7. Confirm the removal.

Removing an App permanently deletes the App, its channel, and all associated data. This action cannot be undone.