Skip to main content
UNSW Sydney Logo
Teaching
Search
  • About
  • Teaching
    • New to teaching
    • Educational design
    • Assessment and feedback
    • Evaluating education
    • AI in teaching and learning
    • More...
  • Educational Technology
    • Support
    • Training
    • EdTech resources
    • Media & immersive
  • Events & News
    • Upcoming events
    • Recent news
    • Event recordings & resources
    • Subscribe to education news
  • Awards
    • Awards
    • Fellowships
    • Gathering evidence of your teaching practice
  • Professional Development
    • Beginning to Teach (BTT)
    • Teaching Accelerator Program
    • Foundations of L&T (FULT)
    • Course Design Institute (CDI)
    • Program Level Approach to Assessment
    • Self-paced learning
    • Academic mentoring
  • Contact & Support
    • Education contacts and support
    • UNSW's Teaching Commons

Breadcrumb

  1. Teaching
  2. Educational Technology Support
  3. Resources

Blackboard Ally

Blackboard Ally

Blackboard Ally is an additional service within Moodle which produces an accessibility score for each file you upload to your course. It automatically checks course materials against WCAG 2.0 accessibility standards. Ally provides guidance and tips for lasting improvements to your content accessibility.

In addition to providing you with insight to your content accessibility, Ally automatically creates alternative versions of your files. This allows students to choose the type of file they want that best suits their needs. While you're in the process of improving files, students still access alternative copies.

The below video will gives a brief explanation on how you can use Blackboard Ally features to improve the accessibility for your course documents.

Currently, Ally checks files in these formats:

  • PDF files

  • Microsoft® Word files

  • Microsoft® PowerPoint® files

  • OpenOffice/LibreOffice files

  • Uploaded HTML files

Accessibility scores are determined by the severity of issues in each file. A low score indicates the file has severe or multiple accessibility issues; a high score means there are minor or no accessibility issues. For accessibility scores less than 100 percent, Ally gives you suggestions for improving the accessibility of the file.

Scores range from Low to Perfect. The higher the score the fewer the issues.

  • low Low (0-33%): Needs help! There are severe accessibility issues.

  • medium Medium (34-66%): A little better. The file is somewhat accessible and needs improvement.

  • high High (67-99%): Almost there. The file is accessible but more improvements are possible.

  • perfect Perfect (100%): Perfect! Ally didn't identify any accessibility issues but further improvements may still be possible.

Scores are only visible to the course Instructors.

View File Accessibility Issues

For files with Low to High accessibility scores, Ally can point the possible issues with the file and gives a step-by-step guide on how to rectify them to improve the Accessibility.

 

Steps to improve the accessibility:

 

  1. Once you have uploaded the file onto your course, the accessibility score pointer will show up adjacent to the name of the file. Click on this pointer to view the Instructor Feedback panel. 
    Please note, It takes a couple of minutes from the time you uploaded the file for the accessibility score to appear. 

    Powerpoint resource with red ally gauge and download icon
  2. This section has all the details to help you fix the accessibility. 
  3. Select All issues to see the list of issues with the file. 
    khi
  4. Find the issue you want to work on and select Fix.This will give you suggestions on how to fix the issue. 
    man
  5. You also have an option to view the alternative file formats available for students to download.
    Astra logo beside powerpoint resource with download button highlighted

    hh

Additional details on improving file accessibility is available here.

Previews and highlights

As part of Blackboard's regular Ally release updates, the instructor feedback will now be able to show previews for the following document types;

  • PDF
  • Microsoft Word
  • Microsoft PowerPoint

Previews can be used to pinpoint accessibility issues within the document. Highlights are currently provided for the following accessibility types; 

  • Images without an appropriate alternative description
  • Text fragments with insufficient contrast
  • Tables without table headings

The introduction of this feature will make it easier for instructors to identify issues within a document as well as cut down remediation time. For all other accessibility issues, Ally will still advise you of these without highlights. An example of the preview/highlights screen below;

  1. Page navigation: You may type or use arrow buttons to navigate through your document. 
  2. Highlight navigation: Use the arrow button to navigate lines within your document that contain the accessibility issue. In this example, there are 18 lines which ally has highlighted and shown to have contrast issues which require remediation.
  3. Hide / Show highlight button: You may choose to hide or show the highlights on your document. Maybe useful when you have multiple issues and with to only filter out 1 specific kind. 
  4. Ally side panel: Shows your documents accessibility score, provides information about the issues identified/advice on how to fix (if applicable) and option to re-upload corrected version.
  5. Highlights: Highlighted in red, are the areas which require remediation.

Accessibility in PDF's and Word

Background

Most documents are created in word-processing programs such as Microsoft Word or PowerPoint before they are converted to a PDF. Many programs create PDF files, but few produce structured or tagged PDF's. PDF tags are hidden labels that clarify the structure of the document (E.g. Table, heading, paragraph, etc.) Untagged PDF's do not contain any of this information and can cause the content to be misinterpreted.

When you upload a PDF document into your Moodle course, Blackboard Ally will analyse your document and provide you with an accessibility score. Depending on how well your document has been created to address accessibility, coloured icons will appear which correlate to an accessibility percentage score. The higher the score, the more accessible your PDF document is.

Red arrow pointing to red Ally gauge beside PDF resource titled "Week 1: Introduction"

In the example above, it appears the PDF document uploaded has a low accessibility score. The below will outline some changes you can choose to make when creating your PDF's to improve its accessibility score.

Tagging a PDF 

A great way to create a tagged PDF is with an editable source document, such as a Word, PowerPoint or LibreOffice file. The below screenshot demonstrates key settings to enable with a Microsoft Word file.

  1. Save the document as an Adobe PDF.
  2. Click Options.
  3. Make sure  Enable Accessibility and Reflow with tagged Adobe PDF  is enabled.
  4. Click OK.

Adding headers in tables

Using proper table headers will help readers understand how the tables are organised into columns and rows. It's recommended to avoid solely using text and cell formatting, such as making the text big or bold to mimic the visual appearance of a table header. This provides no underlying information about the structure of the table.

  1. Select the top row of your table and right click.
  2. Choose Table Properties.
  3. Select Repeat as header row at the top of each page.
  4. Click OK.

 

Ensuring your top header style is 'Heading 1'

Many times, larger fonts are used for headings, however, it's important to select the styled heading instead. Top level headers should be Header 1.

  1. Highlight your heading.
  2. Select Heading 1 from the style bar.

Adding a title 

Make sure you include a title for your document using the Title style. 

  1. Highlight your title.
  2. Select Title from the style bar.

Add metadata in the document

Once you have made the PDF document adding metadata further improves accessibility.

  1. In Adobe Pro (or alike), open the document, select File.
  2. Select Properties
  3. Enter in all necessary information such as;
  • Title
  • Subject
  • Keywords

 

Include 'Alternative descriptions' for images

An alternative description is a textual alternative for an image. It makes it easier to connect the image to its context and allows students with visual impairments to perceive the image. 

Alternative descriptions should be added to all images, including those embedded within PDF, Word, PowerPoint and other documents. 

  1. Right click on an image in your document.
  2. Select Format Picture.
  3. Click the Alt Text tab.
  4. Enter in your description.

 

Completed

Once the above steps have been followed, your document should now have a higher (in some cases 100%) accessibility score. 

FAQs

Further details and FAQs can be found on the Blackboard site here.

Further Support

For additional assistance with Blackboard Ally please contact EdTech Hub. 

Events & news

Using the “Multiple-layer feedback Model”
LinkedIn: How can this platform work for you?
More
Back to top
  • Print
  • Home
  • About
  • Teaching
  • Educational Technology
  • Events & news
  • Awards
  • Professional development
  • Contacts

AUTHORISED BY PRO VICE-CHANCELLOR EDUCATION
UNSW CRICOS Provider Code: 00098G, TEQSA Provider ID: PRV12055, ABN: 57 195 873 179
Teaching at UNSW, Sydney NSW 2052, Australia Telephone 9385 5989

ACKNOWLEDGEMENT OF COUNTRY
UNSW respectfully acknowledges the Bidjigal, Biripi, Dharug, Gadigal, Gumbaynggirr, Ngunnawal and Wiradjuri peoples, whose unceded lands we are privileged to learn, teach and work on our UNSW campuses. We honour the Elders of these Nations, as well as broader Nations that we walk together with, past and present, and acknowledge their ongoing connection to culture, community and Country.
- The Uluru Statement
 


  • Privacy Policy
  • Copyright & Disclaimer
  • Accessibility
  • Complaints
  • Site Map
  • Site Feedback
Page last updated: Thursday 6 March 2025