HTML Creating an HTML Sitemap Page

An HTML sitemap is a page that lists important website sections for people. It helps visitors find pages when they do not know where to start. The important question is always where the link leads and whether the person reading the page can predict it.

What You Need to Know

Group links into understandable categories, and keep their destinations accurate. This human-facing page is different from an XML sitemap used by crawlers.

Links are the pathways through a website. The words on a link should help someone choose where to go before clicking it.

Example: See It in Action

Here is a simple example to experiment with. Type it, save the file, and check what the browser displays.

This is a short HTML fragment. To try it as a webpage, put it inside the body element of a complete HTML document.

<nav aria-label="Site map">
    <h2>All pages</h2>
    <ul>
        <li><a href="index.html">Home</a>
        </li>
        <li><a href="projects.html">Projects</a>
        </li>
        <li><a href="contact.html">Contact</a>
        </li>
    </ul>
</nav>

Let’s Understand the Example

• An a element becomes a working link when it has an href. Its visible text should tell readers where they will go.
• Nav identifies a major collection of navigation links.
• Li is one item inside a list. Keep each item inside its parent list.
• Aria-label supplies an accessible name when a visible label is unavailable or inadequate.
• Href contains the destination of a link. A value starting with # points to an id on the same page.

The first example link points to index.html. Check whether that destination exists relative to the document. A link changes where readers go; it does not perform an action such as saving a form.

What Should You See?

You should see a link named “Home”. Selecting it leads to index.html when that destination exists. Try it with the mouse and the keyboard.

Imagine this link is read out of context. Would its text still explain the destination? Rename unclear links before trying to make them look nicer with CSS.

Try It Yourself

1. Add a Learning section with links to three lessons.
2. Save your changes, open or refresh the page, and compare the result with the original example.
3. Tell a friend what your change did. If you are not sure, undo it, refresh the page, and compare.

Common Beginner Mistakes

• Treating an HTML sitemap as a replacement for useful navigation on every page.
• Avoid dead links, empty href values and clickable-looking text without a real destination.

Key Takeaways

• An HTML sitemap is a page that lists important website sections for people.
• An a element becomes a working link when it has an href. Its visible text should tell readers where they will go.
• Group links into understandable categories, and keep their destinations accurate. This human-facing page is different from an XML sitemap used by crawlers.