UT San Antonio Academic Innovation

How to Resolve Accessibility Checker Issues in Simple Syllabus

Updated on

Overview

The Simple Syllabus Accessibility Checker is designed to help you make your syllabus clear and usable for all students, including those who use assistive technologies such as screen readers. Before your syllabus can be published, it will need to pass the Accessibility Checker. If any issues are found, you’ll see a list of items to review along with guidance on how to fix them. This guide walks you through each type of issue and provides simple steps and tips to resolve them.

Using the Accessibility Checker

Before reviewing the details below, we recommend starting with the Accessibility Checker in Simple Syllabus. The checker will highlight any items that need attention and, in some cases, provides one-click fixes to resolve them quickly.

To open the Accessibility Checker, select the accessibility icon on the bottom right side of the screen.

If your Submit button is greyed out and you see the message below, it means there are still a few items to review:

A rich text editor interface shows selected content formatted as a bulleted list. The toolbar at the top includes formatting options, with the unordered list button highlighted and a tooltip visible.

What the Accessibility Checker Looks For

Below are the accessibility checks included in Simple Syllabus. Select each section to learn what the issue means and how to fix it.

Expand or collapse content Unformatted Lists

What this means

Content that looks like a list may not be formatted using the list tools in the editor. This often happens when content is typed or pasted in as plain text instead of using the built-in list options.

Why it matters

When a properly formatted list is used, screen readers will announce "list, 8 items," which helps students understand they are entering a grouped set of information. Without this structure, the content may be read as a continuous block of text, making it harder to follow and understand. Proper lists also improve readability for all students, especially when scanning key points or instructions.

How to fix it

  1. Highlight the items in your list.
  2. Select the bulleted list or numbered list option in the editor.
A rich text editor displays a section titled “Weekly Participation Expectations” with a bulleted list highlighted. Items include reviewing readings, participating in discussions, submitting assignments on time, checking announcements twice weekly, and contacting the instructor or classmates for support.

Helpful tips

  • If your list was created by typing or pasting content, it may not be recognized as a true list.
  • Even if it looks correct visually, it still needs to be formatted using the list tools.
  • This is a quick fix and usually only takes a few seconds.
Expand or collapse content Table Captions

What this means

A table is included, but it does not have a caption explaining what the table represents.

Why it matters

Tables often contain important information, but without a caption, students may not immediately understand what the table is showing or why its included. A caption acts like a title, giving students quick context of the contents of the table. This is especially helpful for students using screen readers, who rely on that context to navigate efficiently.

How to fix it

  1. Click into the table.
  2. Click the Add table caption icon.
  3. Add a short caption that describes what the table is showing.
A table within a web editor is selected, showing a floating toolbar with table editing options. A tooltip highlights the “Add table caption” control, indicating an accessibility feature.

Helpful tips

  • Think of the caption as a title for your table.
  • A simple phrase like "Grading Breakdown" or "Course Schedule" is often enough.
Expand or collapse content Sequential Headings

What this means

Headings may not be used in a clear or consistent order, or content may be styled to look like a heading without actually being formatted as one.

Why it matters

Headings create structure in your syllabus, similar to sections in a document. This structure allows students to quickly scan and locate information such as policies, assignments, or schedules. For students using screen readers, headings act as navigation points, allowing them to jump between sections. When headings are used consistently, it makes the syllabus easier to navigate for everyone, not just those using assistive tools.

How to fix it

  1. Use heading styles from the editor (H3 and H4) for section titles.
  2. Keep headings in a logical order (for example: H3 followed by H4, not skipping levels).
  3. Avoid manually styling text (bold, larger font) to act as a heading.
Text editor displays a comparison of headings using incorrect levels (H4 before H3) and a corrected sequence with properly ordered headings.

Helpful tips

  • If you copied content from another document, headings may not carry over correctly.
  • If something looks like a heading but isn't behaving like one, reapply the heading style.
  • H1 and H2 headings are reserved for the template.
Expand or collapse content Table Headers

What this means

A table is missing a defined header row that labels the data.

Why it matters

Headers tell students what each column or row represents. For example, without headers like "Assignment," "Due Date," or "Points," the data in a table can be unclear. Screen readers rely on these headers to provide context as users move through the table. Adding headers ensures that the information is understood as intended, rather than being read as disconnected values.

How to fix it

  1. Click into the table.
  2. Click the Table Header button to add a table header row.
  3. Fill in the table header with the appropriate column titles.
A web-based editor shows a table with columns labeled “Letter Grade” and “Grade Range.” The top row is styled as a header, and a floating table editing toolbar is open above the table. The “Table Header” option is highlighted with a tooltip, indicating it is being used to improve table accessibility.

Helpful tips

  • The first row is usually your header (for example: Assignment, Due Date, Points).
  • Most tables only need a header row to meet this requirement.
Expand or collapse content Color Contrast

What this means

The color of the text and its background may be too similar, making the content difficult to read.

Why it matters

Low contrast can make text hard to read for many students, especially those with visual impairments or those viewing content on different screens or lighting conditions. Improving contrast makes your syllabus easier to read for everyone. In many cases, this simply means avoiding very light text colors or unusual color combinations.

How to fix it

  1. Use darker text on a light background or light text on a dark background.
  2. Avoid light or overly bright colors for text.
A web-based editor shows a color selection panel open with a grid of color swatches and a HEX input field. Below, two sections labeled “Before” and “After” compare text readability. The “Before” example shows red text on a similar-colored background with poor contrast, while the “After” example shows the same text in a darker color with improved contrast.

Helpful tips

  • Content pasted from Word or websites often brings in color formatting that may need to be removed.
Expand or collapse content Image Alt Text

What this means

An image is included without a description that explains its content or purpose.

Why it matters

Students who use screen readers cannot see images, so they rely on alt text to understand what the image represents. Adding alt text ensures that all students receive the same information, whether its a diagram, chart, or visual example. It also helps clarify the purpose of the image, even for students who can see it.

How to fix it

  1. Click on the image.
  2. Select the T (alt text) option.
  3. Add a short description of the image and click update.
A web-based editor shows an image selected within the content area. A floating toolbar appears above the image with multiple editing icons, including an option labeled “Alternative Text,” which is highlighted with a tooltip.

Helpful tips

  • Focus on the purpose of the image, not every detail.
  • If the image is decorative and doesn't add meaning, you can mark the image as decorative.
Expand or collapse content Empty Headings

What this means

A heading has been added but does not contain any text. This often happens accidentally when editing or adding spacing.

Why it matters

Screen readers use headings to navigate content. An empty heading can interrupt that navigation and create confusion, as it signals a section that doesn't actually exist. Cleaning up empty headings helps maintain a clear and consistent structure throughout your syllabus.

How to fix it

  1. Add text to the heading or remove the heading if its not needed.
A web-based editor shows a section titled “Course Schedule,” followed by a blank line that is formatted as a heading. The heading style dropdown is open with “Heading 3” selected, indicating that an empty heading has been applied.

Helpful tips

  • This often happens accidentally when pressing Enter multiple times.
  • It can also happen when deleting text but leaving the heading behind.
  • If you notice extra spacing, check for an empty heading instead of adding more line breaks.
Expand or collapse content Heading Length (Maximum 120 Characters)

What this means

A heading is longer than 120 characters, often because it includes too much detail or is written as a full sentence.

Why it matters

Headings are meant to act as quick labels for sections. When they are too long, they become harder to scan and navigate. Short, focused headings make it easier for students to find information quickly and understand the overall structure of the syllabus.

How to fix it

  1. Shorten the heading to focus on the main idea.
A web-based editor shows a “Before” and “After” comparison of heading text. The “Before” section contains a long heading reading “Weekly Participation and Engagement Expectations Including Discussion Posts, Responses, and Group Collaboration Activities.” The “After” section shows a shorter heading, “Weekly Participation Expectations.”

Helpful tips

  • Aim for a short phrase instead of a full sentence.
  • If your heading feels long, consider moving extra detail into the paragraph below.

Support

For support, email [email protected], call 210-458-4520, or book a consultation with our TLDT experts. 

Previous Article Simple Syllabus Transition FAQs (Faculty)
Next Article Working with Section Syllabi in Cross-Listed Courses (Faculty)
Still Need Help? Contact Academic Innovation