# Blender Extension Repository

The Poly Hammer Portal hosts a Blender extension repository so you can install and stay up to date with your purchased addons directly from Blender.

Canonical URL: https://docs.polyhammer.com/portal/blender-extension-repo
Product: Poly Hammer
Version: current
Channel: central

<div style={{"textAlign":"center"}}>
    [Video tutorial: YouTube video player](https://www.youtube.com/embed/WvJCRUxT5c0?si=xNvKp8uWGr9XyGV9)
</div>

The [Poly Hammer Portal](https://dashboard.portal.polyhammer.com) hosts a Blender extension repository so you can install and stay up to date with your purchased addons directly from Blender.

<Callout type="info" title="Note:">
This is how you will install our addons. You will need to create an account, or activate your account based on an email you would have received when you made your purchase.
</Callout>

## Get an API Key [#get-an-api-key]

1. Sign in to the [Poly Hammer Portal](https://portal.polyhammer.com) and open the product you own from the **Products** page.
2. Click **Install Now** to go to the **Keys** page.
    <div style={{"textAlign":"center"}}>
        ![GitHub verify](https://docs.polyhammer.com/assets/images/poly-hammer-portal/blender-extension-repo/1.png)
    </div>
3. Create a new API key and copy it.
    <div style={{"textAlign":"center"}}>
        ![GitHub verify](https://docs.polyhammer.com/assets/images/poly-hammer-portal/blender-extension-repo/2.png)
    </div>

## Add the Repository in Blender [#add-the-repository-in-blender]

1. In Blender, open `Edit > Preferences > Extensions`.
2. Add a new **Remote Repository**.
3. Paste your API key into the **Access Token** field.
4. Paste the repository URL shown on the portal's **Keys** page into the **URL** field.
5. (Optional) Enable **Check for updates on startup**.
6. Click **Create**.

<div style={{"textAlign":"center"}}>
    ![GitHub verify](https://docs.polyhammer.com/assets/images/poly-hammer-portal/blender-extension-repo/3.png)
</div>

## Install an Add-on [#install-an-add-on]

1. In the **Extensions** preferences, select your new remote repository and click **Refresh**.
2. Search for the add-on (for example, `Character Control Rig`) and click **Install**.

<div style={{"textAlign":"center"}}>
    ![GitHub verify](https://docs.polyhammer.com/assets/images/poly-hammer-portal/blender-extension-repo/4.png)
</div>

## Update an Add-on [#update-an-add-on]

When a new release is available, refresh the repository (or let Blender check on startup) and click **Update** next to the add-on to get the latest version.
