# Install addons

Source: https://docs.settlemint.com/docs/user-guides/system-addons/install-addons
Learn how to discover and install system addons from the on-chain Directory registry.
The Add-ons settings page shows addon types that are visible for administrator installation.




The Add-ons settings page shows the Directory-registered addon types available for administrator installation in your environment.

![Available addons including XVP settlement and yield schedules](/docs/screenshots/settings/addons.webp)

## Prerequisites [#prerequisites]

* Platform administrator access
* Understanding of which addon types your organization needs

## Install from Settings [#install-from-settings]

<Steps>
  <Step title="Navigate to Add-ons">
    Go to **Settings** > **Add-ons** in the platform navigation.
  </Step>

  <Step title="Browse available addons">
    The page displays visible addon types registered in the Directory. Each visible addon shows its name, description, and category.

    Visible addon types include:

    * **XvP Settlement** - Atomic multi-party exchanges
    * **Yield Schedule** - Automated yield distributions
    * **Airdrop** - Token distribution mechanisms
  </Step>

  <Step title="Install an addon">
    Click **Install** on the addon you want to enable. The system deploys the addon to your platform.

    Once installed, the addon status changes to "Installed" and becomes available for use with your assets.
  </Step>

  <Step title="Configure the addon">
    After installation, you can configure addon-specific settings such as:

    * Default parameters for new instances
    * Role assignments
    * Integration options
  </Step>
</Steps>

## Install during onboarding [#install-during-onboarding]

When creating a new tokenized asset, you can install addons as part of the onboarding wizard:

<Steps>
  <Step title="Start asset onboarding">
    Begin creating a new asset through the onboarding wizard.
  </Step>

  <Step title="Select addons">
    On the Add-ons step, browse available addon types from the Directory. Select all addons your asset needs.
  </Step>

  <Step title="Configure each addon">
    For each selected addon, provide the necessary configuration: - Initial parameters - Access controls - Integration
    settings
  </Step>

  <Step title="Complete onboarding">
    Finish the wizard. Selected addons are installed and configured automatically.
  </Step>
</Steps>

## Understanding addon types [#understanding-addon-types]

The Directory registry supports several addon categories:

### Distribution addons [#distribution-addons]

* **Push Airdrop** - Admin-initiated token distribution
* **Vesting Airdrop** - Time-locked token releases with schedules
* **Time-bound Airdrop** - Limited window token claims

### Exchange addons [#exchange-addons]

* **XvP Settlement** - Atomic cross-party asset exchanges

### Income addons [#income-addons]

* **Yield Schedule** - Automated yield and dividend distributions

<Callout type="info" title="Vault boundary">
  Vault is a contract-level multi-signature treasury capability, not a visible Add-ons settings installer. For the vault
  contract model, roles, and transaction lifecycle, see the [Vault architecture
  reference](/docs/architecture/components/capabilities/vault).
</Callout>

## After installation [#after-installation]

Once an addon is installed:

1. **Authorized users can create instances** - Users with appropriate permissions can create specific addon instances for their assets
2. **Operations are recorded on-chain** - All addon activities create audit trails
3. **API access is available** - Integrate addon functionality into your workflows

<Callout type="info" title="Need help?">
  Contact your platform administrator if you need assistance selecting or configuring addons.
</Callout>

## Troubleshooting [#troubleshooting]

| Issue                           | Solution                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------- |
| Addon not appearing in list     | Verify the addon type is registered in the Directory. Contact platform administrator. |
| Cannot install addon            | Ensure you have administrator permissions.                                            |
| Addon installed but not working | Check addon configuration and user permissions.                                       |

## Related [#related]

* [System addons introduction](/docs/user-guides/system-addons/introduction)
* [XvP settlement overview](/docs/user-guides/system-addons/xvp-settlement/overview)
* [Vault architecture reference](/docs/architecture/components/capabilities/vault)