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

> ## Agent Instructions
> OwnPay is licensed under AGPL-3.0 and is completely free - no licensing fees.
> Production docs URL: https://ownpay.org/docs - append .md to any page URL for clean markdown.
> OwnPay requires PHP 8.3+, MySQL/MariaDB, and Redis.
> MCP server available at https://ownpay.org/docs/mcp for programmatic documentation queries.
> Use root-relative links (e.g. /quickstart) for internal navigation - do NOT include /docs prefix.
> Plugin development: consult /developer/plugins/ pages for correct interfaces and manifests.
> Canonical locations: API auth = /api/authentication, webhook verification = /api/webhooks, rate limits = /resources/rate-limiting, transaction statuses = /fundamentals/payment-flow.
> The documentation uses the Diataxis framework: Tutorials (learning), How-to (tasks), Reference (lookup), Explanation (understanding).

# Addons

> Install and manage built-in and marketplace addons that extend OwnPay with email, Telegram, and other functional capabilities.

Addons are a specialized plugin type that provide functional capabilities to OwnPay - such as email delivery, Telegram notifications, and other integrations. They are managed from their own section for convenience.

<Info>
  Addons are technically plugins of type `addon`. For the general plugin management interface, see [Plugins](/docs/system/plugins).
</Info>

## Built-in addons

OwnPay ships with two built-in addons that are available immediately after installation:

<CardGroup>
  <Card title="mail-gateway" icon="mail">
    Provides SMTP email delivery for transaction notifications, password resets, and custom templates. See [Email Notifications](/docs/notifications/email) for configuration.
  </Card>

  <Card title="telegram-bot" icon="message">
    Sends real-time push notifications to a Telegram chat for payment and refund events. See [Telegram Notifications](/docs/notifications/telegram) for setup.
  </Card>
</CardGroup>

## Install from marketplace

<Steps>
  <Step>
    Navigate to **System > Addons** and click **Browse Marketplace**.
  </Step>

  <Step>
    Browse available addons. Each listing shows a description, version, and compatibility.
  </Step>

  <Step>
    Click **Install** on the addon you want. OwnPay downloads and installs it automatically.
  </Step>

  <Step>
    Activate the addon and configure it for your brands.
  </Step>
</Steps>

## Upload an addon

If you have an addon ZIP file (from a developer or a custom build), click **Upload Addon** and select the file. The same [sandbox scanning](/docs/system/plugins#plugin-sandbox-scanning) applied to plugins is used for addon uploads.

## Activate per brand

Click **Settings** on any addon row to open its configuration panel. Here you can:

* Toggle the addon **Active** or **Inactive** globally
* Select which **brands** the addon applies to
* Configure addon-specific settings (API tokens, chat IDs, etc.)

## Addon lifecycle

| Action         | Effect                                                |
| -------------- | ----------------------------------------------------- |
| **Activate**   | Enables the addon for selected brands                 |
| **Deactivate** | Disables the addon without removing configuration     |
| **Update**     | Applies a newer version when available                |
| **Uninstall**  | Removes the addon, its files, and all stored settings |

<Warning>
  Uninstalling the mail-gateway addon will stop all email delivery. Uninstalling the telegram-bot addon will stop all Telegram notifications. Make sure you have an alternative notification channel before uninstalling.
</Warning>

## Related Pages

* [Email Notifications](/docs/notifications/email) - Configure SMTP through the mail-gateway addon
* [Telegram Notifications](/docs/notifications/telegram) - Set up Telegram bot notifications
* [Plugins](/docs/system/plugins) - General plugin management including gateways and themes


## Related topics

- [Addon Plugin Development - Build General-Purpose Extensions](/docs/developer/plugin-types/addon.md)
- [AI Tools](/docs/developer/ai/overview.md)
- [Plugin System](/docs/developer/plugins/overview.md)
- [Telegram Notifications](/docs/notifications/telegram.md)
- [Email Notifications](/docs/notifications/email.md)