Using buffer to set image descriptions
Tags: a11y, tipstricks, socialmedia
Published: 2019-03-11 14:03:04

---
title: Using buffer to set image descriptions
published: true
description: My strategy to provide alt-text when sharing content
tags: accessibility, a11y, tips & tricks, social media
---

*This is cross-posted from [my blog](https://www.juliaferraioli.com/blog/2019/01/setting-image-descriptions/).*

Descriptions on images, also known as [alt-text](https://en.wikipedia.org/wiki/Alt_attribute), are important for people reading your content using a screen reader or other assistive technology. Screen readers synthesize on-screen text, which allows people who are blind or have low vision to interact with technology. However, images cannot be "read out loud" the same way that text can, so screen readers rely on the person posting the image to set the description via alt-text, and synthesize that property instead.

This used to primarily concern designers and software developers, who would make sure that each image had its alt-text properly set so that everyone could use what they built. Now, many sites rely heavily upon user content, which means that sites leave setting the descriptions up to the users who post the images. Unfortunately, providing these descriptions is not always very discoverable -- if possible at all.

<center><img src="https://juliaferraioli.com/blog/images/setting-image-descriptions/image-sharing-flow.png" alt="A flow chart depicting an image and description pointing to buffer, which then points to Twitter and Instagram"></center>
<center>**My typical flow to share images and setting alt-text**</center>

I've been relying more and more on [buffer](https://buffer.com) to facilitate providing alt-text for different sites. This lets me set the description with services that allow it via the API ([Twitter](https://developer.twitter.com/en/docs/media/upload-media/api-reference/post-media-metadata-create)) while simultaneously sharing it to services that don't (Instagram, LinkedIn). If sharing a link, it also gives me the ability to select what image to use from the article, *and* provide alt-text for that as well.

Actually figuring out *how* to enter a description isn't super discoverable on desktop. You have to hover over the image itself to get the "add description" option:

<center><img src="https://juliaferraioli.com/blog/images/setting-image-descriptions/buffer-browser.png" alt="The buffer web-based posting interface, with the mouse hovering over an uploaded image, which displays the hover-text &quot;Click to expand & add description&quot;"></center>
<center>**Adding image descriptions in a browser**</center>

I like the mobile experience better, because the option to add the description is clearly visible:

<center><img src="https://juliaferraioli.com/blog/images/setting-image-descriptions/buffer-app.png" alt="The buffer Android app interface with an image uploaded and a clearly visible button labeled &quot;Add Description&quot;"></center>
<center>**Adding image descriptions in the app**</center>

That's *how* to set alt-text using buffer, but what should the alt-text actually be? There's a lot of guidance online, but [this site explains some best practices](https://support.siteimprove.com/hc/en-gb/articles/115000013031-Accessibility-Image-Alt-text-best-practices) for crafting the text itself. My rules of thumb are:

* Be concise: alt-text will be read out loud by a screen reader
* Aim for parity: convey the same information that you expect the user would glean from the image
* It's not a caption: alt-text should provide information, not commentary

Hopefully, this gives you a strategy for making your social content accessible. I'll cross my fingers that more platforms will add support for setting alt-text, not just in their user interfaces but in their APIs as well, so that integrations like [buffer](https://buffer.com) can take advantage of them. Go forth and describe!