Check and improve the accessibility of Moodle course content

Updated on: 20 May 2026

How to use Ally to address accessibility issues in your Moodle course.


Overview

Ally is a software integration present in the University's Moodle sites that helps:

This guide focuses on the use of Ally by course editors, including how to:

  • access the Ally Accessibility Assistant designed to help you make improvements
  • fix the most common accessibility issues identified by Ally

Checking for accessibility

You can check the accessibility of your course content in Moodle in two ways.

1. Accessibility indicators

The indicator icons show how accessible each content item is. Clicking an icon opens the Ally Accessibility Assistant, where you can see the item’s score and get guidance on fixing any issues.

The four Ally accessibility indicator icons seen in Moodle courses. The icon that appears by an item depends on the accessibility score it has.

2. Accessibility report

The accessibility report shows an accessibility overview for the entire course, including all assessed content items. Choose Reports then Accessibility report to access it.

Screenshot of a course showing the Reports tab under the course name and the Accessibility report option that appears.

The accessibility report opens in a separate browser tab and displays an easy to navigate summary. Select Start to reach content with the easiest issues to fix.

Screenshot of an accessibility report for a course.

This shows a list of content items with problems. Click any item to open the Ally Accessibility Assistant, which will guide you through the issues, explain their impact and tell you how to fix them. 

If your file has more than one issue, you can click on All issues to display them.

Screenshot of the Ally Accessibility Assistant with the 'All issues' option highlighted.

Fixing common issues

Some issues can be fixed in Moodle through the Ally Accessibility Assistant, others need you to open the file in its original application, like Word or PowerPoint.

Solutions to the five most common issues:

  • Fix this issue directly in the Ally Accessibility Assistant in Moodle.

    Add a description into the box provided then click the Add button.

    Tip: If an image adds meaningful information to the course, it requires a description, otherwise you should mark it as decorative. Ally provides advice on writing good image descriptions.

    Screenshot of the Ally Accessibility Assistant showing how to add an image description.

  • This is an issue you cannot correct in Moodle.

    Open the file in the application you created it in.

    If using Word, you can use Microsoft's Accessibility Assistant to resolve the issue. For example, after running the Microsoft Accessibility Assistant in Word, you can see any contrast issue listed.

    Screenshot of Microsoft Accessibility Assistant flagging a Hard-to-read text contrast issue.

    The Microsoft Accessibility Assistant will then give you some suggestions on how to fix this issue.

    Screenshot of Microsoft Accessibility Assistant providing suggestions on how to fix the Hard-to-read text contrast issue.

    Once the issues have been corrected in the original application, save the file and upload it to Moodle through the Ally Accessibility Assistant.

    Screenshot of Ally Accessibility Assistant providing option to upload a new version of the file with sufficient contrast.

  • The Ally Accessibility Assistant will tell you how to fix this issue. You will require access to the original file. To access the instructions, click How to tag a pdf.

    Screenshot of Ally Accessibility Assistant walkthrough on how to fix an untagged document.

  • The Ally Accessibility Assistant will take you through how to fix this issue. You will require access to the original file. To access the instructions, click How to add descriptions.

    Tip: If an image adds meaningful information to the course, it requires a description, otherwise you should mark it as decorative. Ally provides advice on writing good image descriptions.

    Screenshot of Ally Accessibility Assistant showing how to add image descriptions.

  • You can easily add a language directly through the Ally Accessibility Assistant in Moodle, or use its instructions to set the language on the original file and reupload.

    Screenshot of Ally Accessibility Assistant showing how to add a language to a document.

These issues were identified as the most common when we reviewed the Ally Institutional Report.

Ally documentation

For more information, refer to the Ally for LMS Help Centre.


Links to external sites and information

The University is not liable for external web content and may not be aware when this content is changed or removed.


Guide category