Skip to main content
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
  1. 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: 
{
  "image": {
    "alt": "ACME Logo",
    "url": "https://cdn.buttercms.com/ce8qgAuNTNaXuHvZj4xt"
  }
}