> ## Documentation Index
> Fetch the complete documentation index at: https://docs.babbily.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin troubleshooting

> Fix Plugin setup, authorization, permission, readiness, approval, and incomplete-result issues.

Use this guide when a plugin is missing, stuck, disconnected, or returning less context than expected.

## Plugin status meanings

| Status                    | What it usually means                                                           | What to try                                               |
| ------------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------- |
| Not connected             | The app has not been authorized for your account.                               | Choose **Connect** and complete setup.                    |
| Waiting for authorization | The hosted authorization flow is still open or has not finished.                | Finish the app flow, or choose **Continue** to reopen it. |
| Connected                 | Babbily can use the Plugin when the model, tool mode, and permissions allow it. | Ask for the app by name or choose it from the composer.   |
| Cleanup in progress       | Babbily is still disconnecting the app.                                         | Wait a moment, then refresh **Settings > Plugins**.       |
| Disconnected              | The previous connection is no longer active.                                    | Choose **Reconnect** if you want to use it again.         |
| Authorization expired     | The connected app authorization expired.                                        | Choose **Reconnect** and authorize access again.          |
| Authorization revoked     | Access was revoked in Babbily or the connected app.                             | Choose **Reconnect** if you want to restore access.       |
| Needs attention           | Setup or connection verification did not complete.                              | Refresh, reconnect, or contact support if it repeats.     |

## If setup does not open

<Steps>
  <Step title="Allow pop-ups">
    Allow pop-ups for Babbily, then choose **Connect**, **Continue**, or **Reconnect** again.
  </Step>

  <Step title="Finish the app flow">
    Sign in to the connected app and approve the permissions you are comfortable granting.
  </Step>

  <Step title="Return to Babbily">
    Go back to **Settings > Plugins** and wait for the status to refresh.
  </Step>

  <Step title="Try the plugin in chat">
    Ask for the connected app by name, choose it from the composer, mention it with `@`, or use `/` when plugin-specific commands are available.
  </Step>
</Steps>

## Reconnect after the Plugin migration

Babbily retired former Smithery connections when Plugins moved to Composio. Credentials were not transferred between providers.

If an app appears under **Previous connection history**, choose the current Plugin in **Settings > Plugins** and complete the new authorization flow. An older Scheduled Task may also show **Plugin reselection required**. Edit that task, choose the connected Plugins it may use now—even if the choice is none—and save it before running or resuming the task.

## If Babbily cannot find something

Plugin answers depend on what your connected-app account can access.

Try:

* Name the app, folder, channel, project, repository, board, person, or time window.
* Confirm you can open the item directly in the connected app.
* Check whether your app role has permission to view it.
* Use **Manual** mode and choose the plugin directly.
* Reconnect if your app permissions recently changed.

## If an action needs approval

Some plugin actions ask for approval before running. Review the content and destination before approving:

* Recipients and subject lines.
* Documents, sheets, slides, pages, tasks, or records being changed.
* Billing, customer, payment, or support context.
* Automations or workflow changes.

The approval card appears inline in the conversation beside the work that requested it. Choose **Allow** to run the action or **Cancel** to decline it. During Deep Research, canceling also ends the paused run and keeps the sources gathered before the pause in Canvas.

If Deep Research is waiting for approval, the Canvas report keeps the work gathered so far. After you choose **Allow**, give the same report time to continue. If it does not resume, refresh the chat once and check whether the plugin is still connected.

<Warning>
  Do not approve a plugin action unless you understand what it will do.
</Warning>

## If you want to remove access

Use **Settings > Plugins** to disconnect apps where controls are available. If you cannot remove access from Babbily, revoke access in the connected app's own settings and contact support if you still need help.

Removing plugin access does not delete content inside the connected app.

<CardGroup cols={2}>
  <Card title="Plugins" icon="plug" href="/features/plugins">
    Connect apps and understand approval-required actions.
  </Card>

  <Card title="Plugin capabilities" icon="list-checks" href="/features/plugin-capabilities">
    See what each plugin can help you find, reference, draft, or update.
  </Card>

  <Card title="Data controls FAQ" icon="shield" href="/features/data-controls-and-privacy-faq">
    Review plugin privacy and access controls.
  </Card>

  <Card title="Contact support" icon="life-buoy" href="/troubleshooting/contact-support">
    Learn what to include when a plugin still fails.
  </Card>
</CardGroup>