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

# Usage

> Generate alt text for the selected image, all images on a page, or your whole asset library.

## Generate alt text for a selected image

**1. Select an Image element**

In the Designer, select an **Image** element on the canvas. Open **Apps → AltTextLab** and go to the **Selected image** tab.

**2. Add keywords (optional)**

Enter comma-separated keywords, for example `running shoes, blue, men's`.

**3. Choose a destination**

Select **This page only** or **All pages using this image**. See [Element vs. asset alt text](#element-vs-asset-alt-text).

**4. Generate**

Click **Generate alt text**. The result appears with a thumbnail and the text.

To change the text, click **Edit text**, update it, and click **Save text**. To get a new result, click **Regenerate**. It uses the current destination and the same keywords.

## Manage alt text on a page

Go to the **Page images** tab and click **Find all images**. The app scans the current page only and lists Image elements that have an asset.

The list shows the number of images found, the page name, **Refresh**, and **Bulk actions**. Each row has:

| Control | Description |
| - | - |
| Decorative | Marks the image as decorative. See [Decorative images](#decorative-images). |
| Alt text field | Shows the current alt text. |
| Scope | **This page only** or **All pages using this image**. |
| Keywords | Opens a field for comma-separated keywords used during generation. |
| **Update** | Saves your manual edits. Enabled after you change something. |
| **Generate** | Generates alt text and saves it immediately. |

### Manual editing and single generation

Each row works on one image at a time. You can write the alt text yourself or generate it.

**Edit by hand**

1. Click the alt text field and type or change the text.
2. Choose the scope: **This page only** or **All pages using this image**.
3. Click **Update** to save. The button is enabled only after you change something.

To mark an image as decorative, check **Decorative**. The alt text is saved as empty.

**Generate for one image**

1. Optionally click the tag icon and enter comma-separated keywords, for example `running shoes, blue, men's`. The app uses up to six. See [Keywords](#keywords).
2. Choose the scope: **This page only** or **All pages using this image**.
3. Click **Generate**. The app generates the alt text and saves it immediately, replacing any existing text.

To adjust a generated result, edit it in the field and click **Update**.

### Bulk generation

1. Click **Bulk actions**.
2. Select images with the checkboxes, or click **Select all**.
3. Optionally add keywords for all selected images and choose a destination.
4. Click **Generate for selected**, or **Mark as decorative** to mark the selection.

The app shows progress with a percent bar.

> [!NOTE]
>
> Don't close the app while generation is in progress.

## Manage alt text in the asset library

Go to the **Asset library** tab and click **Find all assets**. The app scans your Webflow Assets library ("X of Y assets scanned"), keeps only image files, and shows "N assets found".

Each row has:

| Control | Description |
| - | - |
| File name | The name of the asset. |
| Decorative | Marks the asset as decorative. See [Decorative images](#decorative-images). |
| Alt text field | Shows the current alt text. |
| Keywords | Opens a field for comma-separated keywords used during generation. |
| **Update** | Saves your manual edits. Enabled after you change something. |
| **Generate** | Generates alt text and saves it immediately. |

Changes always go to the asset's alt text, which elements inherit by default. There is no scope option here.

### Manual editing and single generation

Each row works on one asset at a time.

**Edit by hand**

1. Click the alt text field and type or change the text.
2. Click **Update** to save. The button is enabled only after you change something.

To mark an asset as decorative, check **Decorative**. The alt text is saved as empty.

**Generate for one asset**

1. Optionally click the tag icon and enter comma-separated keywords. The app uses up to six. See [Keywords](#keywords).
2. Click **Generate**. The app generates the alt text and saves it immediately, replacing any existing text.

To adjust a generated result, edit it in the field and click **Update**.

### Bulk generation

1. Select assets with the checkboxes, or click **Select all**.
2. Optionally add keywords for all selected assets.
3. Click **Generate for selected**, or **Mark as decorative** to mark the selection.

The app shows a progress bar while it works.

> [!NOTE]
>
> Don't close the app while generation is in progress.

## Element vs. asset alt text

| Destination | What it does | Use it when |
| - | - | - |
| This page only | Writes alt text to that element only. | The image needs different text in different places. |
| All pages using this image | Switches the element to inherit from the asset and writes alt text on the asset in the Assets panel. | You want one description everywhere the image appears. |

## Decorative images

The **Decorative** checkbox tells screen readers to skip the image. The app saves an empty alt text. Use it for images that add no information, such as background flourishes or dividers.

## Keywords

You can add keywords to use during alt text generation. They help with SEO: relevant terms can make the alt text better match what people search for.

The AI works keywords into the alt text only when it's possible and doesn't change the meaning of the image. If a keyword doesn't fit what the image shows, the AI leaves it out.

Keywords can also help the AI understand the context in which the image is used, which can improve the description.

## Tips and limitations

* Generation overwrites existing alt text without confirmation.
* Images are processed one by one.
* The list doesn't update itself. Click **Refresh** after you switch pages or edit in the Designer.
* The app handles Image elements and image assets only. There are no filters, search, or folders. Large libraries take longer to scan.
* Images in CMS collections aren't supported. See [Webflow CMS](https://www.alttextlab.com/docs/integrations/webflow/cms.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.