Posted on

Fix a broken skip link activity

For more information about how to fix broken skip links, examples, and related resources, visit our resolving broken skip link errors article.

Activity steps

For this activity, we’ll be fixing a broken skip link. If you’d like to learn more about creating a skip to content link, check out CSS-Trick’s article on How to Create a “Skip to Content” Link.

  1. Make sure you’re on Chrome, Firefox, or Edge.
  2. Download the WAVE extension.
  3. Use the WAVE extension to run WebAIM’s WAVE tool on this page and select the Details tab. You’ll see the broken skip link error in the example content below. If this was a typical Skip to Content link, it would be above the header and hidden until we tabbed to it.
  4. Select the WAVE extension icon to turn the WAVE tool off. If you skip this step, you’ll lose your changes in the Inspect tool if you try to run WAVE again.
  5. Click on the broken Skip to content link below. You’ll notice the link doesn’t take you anywhere. You will see the ID #main_content added to the URL in the URL bar.
  6. Right click the Skip to Content link and select Inspect.
  7. Locate the href for the Skip to Content link. It should say #main_content. This is the ID we need to add where we want this link to take us.
    Inspect tool with Skip to Content link code

Great! So far, we’ve seen the error in the WAVE tool, and we have the ID we need to add to our page. Ideally, we would now go fix the template of our website, so it fixes the Skip to Content link on all page. For this activity though, we’re going to practice fixing this one page in the Inspect tool.

  1. Locate the Main content heading below. This is where our Broken Skip link should take us.
  2. Right click on the Main content heading and select Inspect.
  3. Right click on the line that says <div class=”main-content”></div> and select Edit as HTML. This line is right above the Main content h2.
    Inspect tool with Edit as HTML on the div code
  4. Add the ID to this line, and select outside of the text box to apply the change. It should now look like the code below.
<div class="main-content" id="main_content"></div>

Now, if you run the WAVE tool again, the error is gone. You can also select the Skip to Content link, which will skip the pretend navigation links and go straight to the main content.

We just updated this in the inspect tool, so if you refresh the page, it will reset the code making the Skip to content link broken again.

You can use these steps to help you identify what’s going on and then make the update like we did here in your own website’s code.


Here is the example content to use with the steps above:

Skip to content

Pretend navigation link

Pretend navigation link

Pretend navigation link

Pretend navigation link

Pretend navigation link

Pretend navigation link

Main content