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

# Adding alt text

> Add alt text to images in your ButterCMS Media Library to improve accessibility and SEO. Learn how to set alternative text and access it through the API.

The addition of alt text is essential for accessibility and SEO. Alt text is used by screen readers to give visually-impaired users context about the image being displayed. Search engines also use alt text to understand and index your images.

### How to add alt text

1. Access your Media Library
2. Select an image or upload a new one
3. Add alt text via the "Alternative Text" field (located below the Name field)

![Media Library Alt Text](https://cdn.buttercms.com/TrQJuXLRdqoBuMfhbjS4)

4. Click the **Save** button to save your changes

### Accessing alt text via API

To view the alternative text in your API response, include the following parameter to your API request URL or the ButterCMS API client — `alt_media_text=1`.

Your API response for media will look like this:

```json theme={null}
{
  "image": {
    "alt": "ACME Logo",
    "url": "https://cdn.buttercms.com/ce8qgAuNTNaXuHvZj4xt"
  }
}
```