> ## 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.

# Troubleshooting

> Fix common errors in the AltTextLab browser extension.

## API key is missing

The extension has no API key configured. This happens when you haven't added a key yet, or it was accidentally cleared.

**To fix:**

<Steps>
  <Step title="Get your API key">
    Log in to [app.alttextlab.com](https://app.alttextlab.com), go to **Settings → API Keys**, and create a new key.
  </Step>

  <Step title="Open extension options">
    Click the AltTextLab icon in your browser toolbar (or find it via the puzzle/extensions icon) and open **Options**.
  </Step>

  <Step title="Save and reload">
    Paste the key into the **API Key** field, click **Save**, then refresh the page.
  </Step>
</Steps>

***

## Invalid API key

The key entered does not match any active key in your account. This usually means the key was typed incorrectly, partially pasted, or has been deleted.

**To fix:**

<Steps>
  <Step title="Generate a fresh key">
    Log in to [app.alttextlab.com](https://app.alttextlab.com), go to **Settings → API Keys**, and create a new key.
  </Step>

  <Step title="Replace the key in the extension">
    Open extension **Options**, clear the existing value, paste the new key, and click **Save**.
  </Step>

  <Step title="Reload the page">
    Refresh the page and try generating again.
  </Step>
</Steps>

***

## Out of credits

Your account has no remaining credits. Generation stops when the balance reaches zero.

**To fix:**

<Steps>
  <Step title="Upgrade your plan">
    Log in to [app.alttextlab.com](https://app.alttextlab.com) and go to **Plans & Pricing**.
  </Step>

  <Step title="Select a plan">
    Choose a plan that fits your usage and complete the payment. If you prefer not to commit to a subscription, enable **Pay as you go** to purchase credits as needed.
  </Step>

  <Step title="Retry">
    Return to the extension and try again.
  </Step>
</Steps>

***

## Something went wrong on the server

The server could not process the image. You are not charged credits when this happens.

**Common causes:**

* The image is behind a login, on a private network, or blocked by bot protection
* The image format is not supported
* A temporary API issue

**To fix:**

1. Open the image URL directly in a new tab — if it redirects to a login page, the image is not publicly accessible
2. Try the extension in an incognito window or from a different network to rule out access restrictions
3. Test with an image from a public site (e.g. [unsplash.com](https://unsplash.com)) to confirm the extension works
4. If the problem persists after a few minutes, [contact support](mailto:support@alttextlab.com)