From Mahara Wiki

Revision as of 17:08, 4 June 2021 by Tish (talk | contribs)

Note: For developers, please see Accessibility Checklist for guidelines on implementing accessibility.

Mahara's goal for accessibility

Mahara aims to be usable by as many individuals as possible, including those with disabilities or special needs. To this end, any discrepancies from major accessibility standards, guidelines or legislation shall be logged as defects in the bug tracker, and tagged with "accessibility", for inclusion in an appropriate release. We have been working on Mahara's accessibility since version 1.9.

Summary of web content accessibility in Mahara

Creating accessible web content is a requirement in many countries. In order to provide international guidelines, the Web Content Accessibility Guidelines (WCAG) were created. There are three conformance levels under the WCAG 2.1, the latest edition of the guidelines: A, AA, and AAA. Each level requires conformance with previous levels and includes its own specific guidelines for how websites should be made accessible. The accessibility standards of New Zealand, Australia, Europe and the USA draw from WCAG 2.1 and require at minimum Level AA conformance.

In order to better understand the status quo of accessibility in Mahara, we tested the software against all three WCAG 2.1 levels.

We grouped Mahara's pages into three categories: pages for viewing web content, pages for creating and editing content, and administration pages. However, we can only test built-in pages and the basic structure of portfolio pages as it is up to the users to ensure the content they upload (i.e. the user-generated content) is accessible.

Accessibility features in Mahara

Here are some of the accessibility features in Mahara. These features were first included in Mahara 1.9. They can be found in both pages for creating and editing content and pages for viewing content.

  • Keyboard-accessible controls and elements
    • People who use only the keyboard can now access the dropdown menus in the main navigation.
    • We have also worked on the keyboard accessibility of the controls for creating pages.
  • Descriptive alt text for images: We have provided alt text for images such as those used in pages for viewing content. This is very important for blind users, so that they can understand the overall content of the pages.
  • Properly labelled graphical links and controls
    • Graphical links such as the one for editing the user's profile picture now have alt text. This lets screen reader users know the purpose of the graphical links.
    • Buttons and checkboxes are now labeled. This is especially helpful in complex forms.
  • Use of focus management: In certain pages, focus is moved to the next logical section after the user has activated a specific button or link. This enables users of assistive technology to quickly determine their location on the page and their next step.
  • Text descriptions for screen reader users: The tabs such as the ones in the Profile page now have a textual indicator informing screen reader users about the currently selected tab.

Administration Pages

Most of the administration pages include the accessibility improvements mentioned above. However, since administration is the most complex part of Mahara, there are still some pages that may have issues. We are continuing to work on Mahara's accessibility and we aim to address these issues in future versions.


Mahara has a good level of accessibility when it comes to viewing and creating content. We are continuing to test the administration pages in order to make them more accessible. With the right configuration, Mahara can be used by organisations that require compliance with WCAG 2.1 Level AA.

For more information on specific issues and their status of investigation, please refer to

We invite people to test changes as they become available and welcome the insight of other accessibility researchers who think there are issues we have not addressed which should be looked into.

If you wish to get involved in fixing these issues, either by providing your development time or by providing funding, please get in touch with us via [email protected]

Individual jurisdictions

New Zealand

The New Zealand Web Accessibility Standard 1.1 is based on the Web Content Accessibility Guidelines (WCAG) 2.1, the international standard for web accessibility. All public service and non-public service agencies must meet the NZ Government Web Accessibility Standard 1.1.


According to Australia's Digital Service Standard, Australian Government agencies are required to meet the Web Content Accessibility Guidelines (WCAG) 2.0 Level AA. This complies with the Disability Discrimination Act 1992, in which Australian Government agencies are required to ensure that information and services are provided in a non-discriminatory accessible manner. Mahara obtained 2.0 Level AA before December 2014.

European Union

Websites for EU agencies created after January 2010 are expected to comply with WCAG 2.0 Level AA, as stated in the IPG Web Accessibility rules. However, existing websites may be gradually improved to this level. We are working to ensure that Mahara remains Level AA conformant.

The United Kingdom

To meet government accessibility requirements in the UK, digital services must meet level AA of the Web Content Accessibility Guidelines (WCAG 2.1) as a minimum. The accessibility regulations came into force for public sector bodies on 23 September 2018. Older intranets and extranets (published before 23 September 2019) need to be made accessible when they are updated. Mobile applications need to be accessible by 23 June 2021.


Section 508 of the US Rehabilitation Act is a law which requires the federal government to use accessible web technologies. This legislation is currently being revised and is expected to draw from WCAG 2.0 Level AA when the refresh comes into effect. We will implement any requirements specific to Section 508 when the refresh is made public.

Other links



See also the Equality Act 2010 Statutory Code of Practice (PDF) for Services, public functions and associations.


European Union