Document how to hide images in Element

[andybalaam]

As discussed within the Trust and Safety Research and Documentation Working Group.

✔️ Checklist

• Check for common mistakes:
  • Wrap plain URLs in <> to linkify them (learn more).
  • Use the right level of headings: The page title will use a level 1 headings, so your headings should use level 2 and below.
  • Use internal links: when linking to another page on https://matrix.org, use the Zola [label](@/target.md) syntax.
• For blog posts:
  • Verify the date and post ordering on the /blog page, especially for multiple posts on the same day. Prefer UTC format, e.g. 2025-12-01T14:00:00Z for Dec 1st, 2025, 2pm UTC.
  • Set the correct author and category. Browse existing ones at https://matrix.org/author/ and https://matrix.org/category/ to match them.
• Let us know if you are contributing in a specific role, such as on behalf of an organisation or team, for example.
• Let us know if your PR is time-sensitive in any way.
• Mention any issues related to the PR. Use GitHub keywords as appropriate.
• Your individual commits or pull request is signed off.

Signed-off-by: Andy Balaam [email protected]

[HarHarLinks]

Relates to #2685

[cloudflare-workers-and-pages]

Deploying matrix-website with    Cloudflare Pages

Latest commit:	6ce03e4
Status:	✅  Deploy successful!
Preview URL:	https://1ca04bcc.matrix-website.pages.dev
Branch Preview URL:	https://andybalaam-hiding-images.matrix-website.pages.dev

View logs

[MTRNord]

I feel like the figure shortcode (see https://github.com/matrix-org/matrix.org/blob/main/CONTENT.md#adding-pictures-in-your-post ) or at least alt text might be nice here. I know the old text didn't do it, but I guess we can take this opportunity to make this a bit more accessible to people? Not sure entirely, though, as the text also explains what has to be pressed.

Happy maybe for input by someone who has more experience with accessibility aid tooling, though.

[andybalaam]

Yes, I definitely agree they should have alt text - it can be very frustrating for people to navigate past images that may or may not contain useful information, so even if it's a repeat I think it should be there.

btw the "adding pictures" part of CONTENT.md is useful and I missed it because it was in the blog section - it would be good to move it I think.

[MTRNord]

Yeah good feedback. Picking that up as a TODO :)

[HarHarLinks]

maybe it would be worthwhile to add some anchor links here to jump to the client that interests me?