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

# Installation

> Install the AltTextLab plugin and connect your API key.

## Install from the Plugin Store

<Steps>
  <Step title="Find the plugin">
    In your Craft CMS control panel, go to **Plugin Store** and search for **AltTextLab**.
  </Step>

  <Step title="Install and activate">
    Click **Install** to install and activate the plugin.
  </Step>

  <Step title="Add your API key">
    In the control panel sidebar, go to **AltTextLab → Settings**. Paste your API key into the **AltTextLab API Key** field and click **Save**.

    You can find your API key in the [AltTextLab dashboard](https://app.alttextlab.com/settings/api-keys). See [API key](/api/api-key) for instructions on creating and managing keys.
  </Step>

  <Step title="Configure language, writing style, and more">
    Before generating alt text, configure your preferred language, writing style, and other options in [Settings](/integrations/craftcms/settings).
  </Step>
</Steps>

<Warning>
  The plugin fetches images by URL, so your site needs to be publicly accessible. If your site is local, password-protected, or behind a firewall, disable **This site is reachable over the public internet** in **AltTextLab → Settings** — the plugin will upload image files directly instead.
</Warning>

## Install with Composer

```bash theme={null}
composer require alttextlab/alt-text-craftcms
php craft plugin/install alt-text-lab
```

or

```bash theme={null}
ddev composer require alttextlab/alt-text-craftcms
ddev craft plugin/install alt-text-lab
```

Then follow steps 3–4 above to add your API key and configure settings.
