Skip to Main Content

LibGuides Accessibility: Best Practices

Alt-Text for Images

Images must have alternate text; this is the description screen readers read aloud. When adding an image in the rich text, please briefly describe the image in the Alternative Text field. The Alternative Text must not be the same as the image file name. 

Videos & Frame Titles

Videos embedded in LibGuides need the following attributes to be accessible:

  • closed captions and/or transcript 
  • a title, if using the embed code

If you embed a video, each FRAME and IFRAME element needs a title attribute. Without it, screen readers read out the file name, which can be meaningless. This is not always provided in the embed code, so please add a descriptive title.

Example: 

Screenshot of adding a youtube video to libguide with red box around title of video in the embed code.

Embedding Documents (MS Word, Mac Pages, Excel, PowerPoint, etc.)

It is recommended that Word documents and PowerPoints should be saved as PDFs. In Adobe Acrobat, create an Accessibility Report on the PDF before including on your LibGuide. If you have questions about this process, contact Samantha McClellan at s.mcclellan@csus.edu. Any Rule Names that have failed or require a manual check will be noted and a hyperlink is provided by Adobe on how to remedy those items. Once fixed, re-run the report to ensure all rules have been addressed.

From there, you can link to the PDF in your LibGuide. Be sure to include "PDF" in the title of the link so that people using a screen reader are notified that they are opening a PDF.

Last Updated: May 28, 2024 10:43 AM