A broken chain

Avoiding Broken Links in Canvas

Has this happened to you? You open an email from one of your students that reads, “I can’t access the required reading file in week 3 of the Canvas course?” Concerned, you open your Canvas course. You check your week 3 module; it’s published and so is your “Required Readings” page. Strange. You open the course page and click on the link to the reading file; it downloads. Even stranger. Your student still insists that they cannot access the file. What is going on???

Instructors working in Canvas can occasionally encounter scenarios like the above where a link, image, or file in their Course works for them but does not work for their students. These errors can be very tricky to diagnose and are often caused by something sneaky going on “under the hood” in Canvas. Thankfully, Canvas has a tool that instructors can use to hunt out bad links in their course. This post introduces Canvas’s course link validator tool and explains how it can be used to proactively detect broken links in your courses. It will also provide a few tips for fixing these issues once they’ve been detected and best practices for avoiding these issues altogether.

Detecting Broken Links

Your secret weapon in this fight against broken links is the course link validator. The course link validator, which can be accessed from the Settings page of your course, scans all content in a course for links that may not work for any of several reasons. It will detect and report links to unpublished content, links to content in another course, and links to external websites that just don’t work. It’s a great idea to run the link validator right before you are ready to publish your course and run it again each time you make a large change or addition.

After running the link validator, Canvas will display a list of each piece of content in your course that contains at least one link that may need your attention. These problematic links are further sorted beneath a description of the cause of the error. In the example screenshot of link validator results below, the validator found five broken links in this course:

The results of a link validation check in Canvas.

  • One embedded image in a quiz question that will not work for students because the embedded image is stored in another course.
  • Three links within a single page that students cannot access because each link points to an object in another course. This page has a link to a page in another course, an embedded image stored in another course, and a link to a file stored in another course.
  • A link in a different page that points to an assignment in this course that has not yet been published.

These results illustrate two of the most common causes for confounding broken links in a course:

  1. Links pointing to unpublished files or other unpublished course content
  2. Links pointing to content that is in a different Canvas course

Both of these issues create links that appear to work fine for the instructor but do not work for students. Without a tool like the course link validator, it would be very difficult to detect these issues!

Defeating Broken Links

Whenever the link validator detects a broken link in your course, it’s time to spring into action and heal those links. Mending links that are broken because they point to unpublished content is straightforward: find that content in your course and publish it! Fixing links that point to content in other courses is trickier.

First, you need to remove the bad link. To do this, find the course content that contains the bad link and edit it. Then remove the bad link or embedded image:

  • For broken links, find the course content that contains the bad link, click edit, click the link in the editor, then click Remove Link.
    The Remove Link option in Canvas
  • For broken embedded images, put your text edit cursor after the image and backspace to remove it.

Once the bad link is removed, use the Canvas editor’s tools to create a new link that points to the course file or course page, or embed the image from your course images. If that file, page, or image you are linking to doesn’t yet exist within the course, you’ll have to upload it from your computer or import it from the other course. Recreating the link in this fashion will point it at content that is contained within the same course, ensuring your students get to where they need to go!

Why Broken Links Happen

These sneakily broken links are typically the result of a teacher trying to share something with their students that their students are not allowed to access. Naturally, teachers are afforded much wider access to a course than students. The most confusing broken links commonly point to either unpublished content or content in another course. Students can’t see unpublished content or content in the teacher’s other courses, but the teacher can!

One item type in a Canvas course that can unexpectedly cause access problems with its published status is course files. Unlike most other content in a Canvas course, you typically don’t have to manually publish course files; most files you upload to a course will be published upon upload. However, files or even entire file folders can be unpublished in your course Files page. When that happens, students will receive access denied messages after attempting to click a link to that file. To resolve this issue, the course instructor must publish the file or folder in the course’s Files page.

Links to content in another Canvas course can sneak in whenever course content is manually copied from one Canvas course and then pasted into another course. The result of copying and pasting between courses creates links to files, pages, and images that point to an outside course. When students try to follow these links, Canvas sees that they are not enrolled in that course and sends an “access denied” message. To prevent this type of broken link, never copy and paste links or images from one Canvas course into another. Instead, use Canvas’s copy and import tools whenever you need to duplicate content from one course to another.

An Access Denied Error in Canvas

Try it Out!

Whether or not you have been bitten by broken links in the past, we encourage you to run the link validator in your Canvas courses. If the validator finds any issues, take a look at those pages in your course and either remake those links or publish any unpublished link targets. You can check to see if your fixes were successful by rerunning the validator and using student view to try the links as the test student. If you’re ever unsure of how to fix an issue reported by the link validator, please don’t hesitate to contact Canvas 24/7 support via the “Help” button in Canvas, email UWGB’s Canvas support team at dle@uwgb.edu, or request a CATL Consultation for one-on-one training on finding and fixing broken links!

Canvas: Rich Content Editor

The Canvas Rich Content Editor (RCE) is an editor for Canvas pages, assignments, discussions, quizzes, and announcements. If you’ve ever edited a Canvas page or added a description to an assignment, you’ve already used it! The RCE allows you to add and format text, insert photos and videos, and link web content in many areas of your course.

Table of Contents

Why Should I Use the Rich Content Editor?

The Rich Content Editor puts many powerful tools right in the fingertips of instructors. Besides allowing you to compose text, it also makes adding images, videos, documents, and links to many areas of your course incredibly easy. By using the RCE to keep relevant materials together in the same area, your students will also feel more confident in what they need to use and when. Consider how you might implement the following practical applications of the Rich Content Editor in your own course:

  • Link files in assignment descriptions. Avoid confusion from students over what materials are relevant to an assignment by linking them right in an assignment description. If your instructions reference a reading, link your PDF where you mention it. If you would like students to fill out and submit a Word doc you created, include a link to the file and then there will be no confusion over which file to use.
  • Update your course materials right in Canvas. Sometimes you may decide to change the details of a project or another course element. Rather than digging through your computer files to update a document and then reuploading it to your course, consider copying the instructions into the appropriate assignment, discussion, or page in your Canvas course where you can easily edit them anytime.
  • Make your course content easy for your students to access. Use the RCE to create your course content in Canvas pages instead of uploading Word or PowerPoint files. Creating your content within Canvas will ensure that your students can access it on all devices and ensure that the ability to view your content isn’t dependent on the installation of specific software. It will also prevent students from having to juggle many tabs and windows at once to switch between downloaded files and your Canvas course.
  • Use videos in new areas of your course. If you’ve taught online, you’ve almost definitely had a video embedded on a page before, but did you know you can also use the RCE to add videos to announcements, discussion threads, and even quizzes? If you’re one that prefers to communicate through speaking rather than written text, consider adding a video to your next announcement (while still including transcripts or a written overview for accessibility).

How Can I Use the Rich Content Editor to Make My Content More Accessible?

Use Built-In Text Formatting

The Rich Content Editor is a great tool for making your course content more readable. It is recommended that you format your text using Canvas’s built-in text styles from the dropdown menu in the Rich Content Editor. For example, Header 2 and Header 3 are great for page headers, while Paragraph is perfect for body text. Using these text styles will keep the appearance of your content consistent across your course, plus the text will scale correctly when a user zooms in on their browser. Canvas formatting also helps screen readers determine which parts of the text are headers and which are body text.

Add Alt Text to Images

Adding alt text to images is another best practice for making your course more accessible. Alt text provides a description of images that is readable by those that use screen readers. When you upload a new image with the New Rich Content Editor, add a brief description in the Alt Text field.

Use the Accessibility Checker

The Rich Content Editor also comes equipped with a built-in accessibility checker that runs some basic checks and makes recommendations to improve the accessibility of the content you are editing.

More Detailed Information

Do more with advanced HTML

You can do more with Canvas pages by using the HTML editor built in. CATL has some more information and sample code available here to get you started.

Reveal Additional Tools with the More Button

To see additional features, click the three stacked dots in the top right corner of the RCE toolbar. Depending on the size of the window in which you have Canvas open, more or fewer tools will be hidden behind this “More…” button.

More options

There is a menu bar at the very top of the Rich Content Editor. From this menu bar you can:

  • Cut, copy, paste, and undo with the Edit menu
  • Toggle between rich text and HTML view with the View menu
  • Insert various types of media, as well as tables and equations
  • Format your text
  • Explore external Tools (this is also where you will embed Kaltura videos)
  • Manage Table properties

Animated demo of the RCE menu

Course content and external content can be linked through the menu bar or toolbar. Photos, documents, URL links, and course content links can be added through the “Insert” menu or the toolbar buttons with icons that match those found within the Insert menu.

Course Link Menu Item

Access Third-Party Tools Through the Menu Bar or Toolbar

Office 365 content and Kaltura/My Media content can be embedded with their respective buttons in the RCE toolbar.

Office and Kaltura Buttons

Other third-party tools like YouTube, Vimeo, and Films on Demand can be accessed through the “Apps” button with a plug icon. You can also access all external tools by going to Tools > Apps > View All in the menu bar. After you use a tool for the first time, it will appear under “Apps” without having to click “View All”.

Apps, My Media

If You Can’t Find What You’re Looking For…

To help you navigate this menu system, we’ve linked instructions below for some common features. Note that the process for each of these is the same whether you are using the RCE in a page, an assignment, a discussion, etc.