YSK: How to embed images accessibly on Lemmy

Why YSK: If you want to make Lemmy a more accessible place for all, you need to know how to add labels (aka: “alt text”) to embedded images

As many of you are already aware, you can embed images in comments using the following markdown: ![](https://example.com/image.jpg).

That works, but the image will be left unlabeled which leaves screenreader users out of the conversation. This may seem like a theoretical problem, but it’s not – Lemmy already has an active blind community: rblind.com

So, here’s what you can do to add labels when embedding images:

![Earth viewed from the Moon](https://example.com/image.jpg)

That’s it! Any text within the [] becomes “alt text”, which is what screenreaders use for describing images. It’s a small thing, but it makes a world of difference.

Remember: Reddit took something from many of us here. For some, it was a mobile app. For others, it was the ability to operate their own communities. Comment with solidarity; use alt-text.

MostlyBlindGamer,
@MostlyBlindGamer@rblind.com avatar

This message is officially approved by RBlind. Thank you.

You are all making the open web a better place.

Elektrotechnik,

Very nice, thanks for the write up!

trouser_mouse,
@trouser_mouse@lemmy.world avatar

This is wonderful advice, it should be in all introduction material.

OtakuAltair,
@OtakuAltair@vlemmy.net avatar

Great YSK! Definitely doing this from now!

Pillarist,

I wish you could post gifs this way.

OtakuAltair, (edited )
@OtakuAltair@vlemmy.net avatar
Pillarist,

‼️ Last time I tried it, it wouldn’t work for me! Thank you!

Lulu,
@Lulu@sh.itjust.works avatar

description is accurate👍

CeruleanRuin,
@CeruleanRuin@lemmy.one avatar

Sweet, I can actually read the alt text by long-pressing the image. This opens up a whole new avenue for good caption gags.

xaxl,

Is there a way to embed the actual image itself and not have to rely on a third party like Imgur?

EgnlishPro,
EgnlishPro,
cypherpunks,
@cypherpunks@lemmy.ml avatar

![Dude, sweet](https://cdn.mos.cms.futurecdn.net/f19cc921c5d2ab5c1c928088f515a330-1200-80.jpg)

that is not how to use alt text.

it should actually be a description of the image, for blind people.

also, web users who aren’t using some accessibility tool can’t even see it without right-clicking and inspecting the element or clicking lemmy’s “view source” button (as i just did to quote your comment here). so, please don’t use alt text for things other than descriptions of images!

BrikoX,
@BrikoX@vlemmy.net avatar

You can also copy and paste the image with Ctrl+C/Ctrl+V directly into the post or comment. Then the only think left is adding the alt text.

calr0x,
LordTE7R1S,

Thanks for this post!

raiun,
@raiun@lemmy.world avatar

Lemmy should do it similar to how I have seen this done on Mastodon. When you upload an image an overlay shows up to remind the user to describe the image before submitting. The typical user is not going to remember to do this.

chaorace,
@chaorace@lemmy.sdf.org avatar

An excellent suggestion! I hope you don’t mind, but I went ahead and created a feature request for this just now: lemmy-ui#1759

rbhfd,

Someone called me out on this yesterday. On a thread about rblind, so deservedly so. I had no idea this is how it works though. Thanks!

fastfinge,

That was me, and my bad. As a blind person myself, I’ve never tried to post an image. I knew including alt text was possible, but I didn’t realize the method was undocumented, and Lemmy doesn’t prompt for it. If I had, I would have offered help, not just snark.

rbhfd,

No worries! I never really considered blind people browsing apps, I only became aware of the technical details since the API changes at reddit, so it’s still far from a reflex to think about.

Thanks for pointing it out though.

rbhfd,

Follow up: did I do it correctly here?

lemmy.world/comment/766594

wit,

This is a really good YSK. Thank you for posting!

chaorace,
@chaorace@lemmy.sdf.org avatar

Unrelated question, but are you a Stormlight Archive reader? I ask because of your username lol

wit, (edited )

YES! But please don’t spoil. I am on the 4th book, Rythm of War, for many months now… I have read 50% but it just goes so slowly… The first and second book, The Way of Kings and Words of Radiance, are my favorite books ever. Wit is one of my favourite characters, just so quick and witty and mysterious…

chaorace,
@chaorace@lemmy.sdf.org avatar

A soldier in the film Starship Troopers speaks directly to the viewer: “I’m doing my part!”

![A soldier in the film Starship Troopers speaks directly to the viewer: “I’m doing my part!”](https://i.kym-cdn.com/photos/images/newsfeed/002/182/171/eb0.jpg)

  • All
  • Subscribed
  • Moderated
  • Favorites
  • random
  • uselessserver093
  • Food
  • aaaaaaacccccccce
  • [email protected]
  • test
  • CafeMeta
  • testmag
  • MUD
  • RhythmGameZone
  • RSS
  • dabs
  • Socialism
  • KbinCafe
  • TheResearchGuardian
  • Ask_kbincafe
  • oklahoma
  • feritale
  • SuperSentai
  • KamenRider
  • All magazines