HTML Guide

To fix the W3C HTML Validator issue stating that a heading element like h1, h2, h3, h4, h5 or h6 must not appear as a descendant of the th element, you need to ensure that the HTML structure follows the specifications where a heading element (h1 to h6) is not placed within a table cell element like th.

Here’s an example of what might be causing the issue and how you can correct it:

Incorrect HTML:

<table>
  <tr>
    <th>Month</th>
    <th><h2>Revenue</h2></th> <!-- Incorrect placement of h2 inside th -->
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

Corrected HTML:

<h2>Revenue per month</h2>
<table>
  <tr>
    <th>Month</th>
    <th>Revenue</th>
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

In the corrected example, the issue is fixed by removing the h2 element from the th element. If you need to style the text inside the th element differently, you can achieve that via CSS without nesting heading elements inside table cell elements.

To fix the W3C HTML Validator issue stating that a heading element like h1, h2, h3, h4, h5 or h6 must not appear as a descendant of the th element, you need to ensure that the HTML structure follows the specifications where a heading element (h1 to h6) is not placed within a table cell element like th.

Here’s an example of what might be causing the issue and how you can correct it:

Incorrect HTML:

<table>
  <tr>
    <th>Month</th>
    <th><h3>Revenue</h3></th> <!-- Incorrect placement of h3 inside th -->
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

Corrected HTML:

<h4>Revenue per month</h4>
<table>
  <tr>
    <th>Month</th>
    <th>Revenue</th>
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

In the corrected example, the issue is fixed by removing the h3 element from the th element. If you need to style the text inside the th element differently, you can achieve that via CSS without nesting heading elements inside table cell elements.

To fix the W3C HTML Validator issue stating that a heading element like h1, h2, h3, h4, h5 or h6 must not appear as a descendant of the th element, you need to ensure that the HTML structure follows the specifications where a heading element (h1 to h6) is not placed within a table cell element like th.

Here’s an example of what might be causing the issue and how you can correct it:

Incorrect HTML:

<table>
  <tr>
    <th>Month</th>
    <th><h4>Revenue</h4></th> <!-- Incorrect placement of h4 inside th -->
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

Corrected HTML:

<h4>Revenue per month</h4>
<table>
  <tr>
    <th>Month</th>
    <th>Revenue</th>
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

In the corrected example, the issue is fixed by removing the h4 element from the th element. If you need to style the text inside the th element differently, you can achieve that via CSS without nesting heading elements inside table cell elements.

To fix the W3C HTML Validator issue stating that a heading element like h1, h2, h3, h4, h5 or h6 must not appear as a descendant of the th element, you need to ensure that the HTML structure follows the specifications where a heading element (h1 to h6) is not placed within a table cell element like th.

Here’s an example of what might be causing the issue and how you can correct it:

Incorrect HTML:

<table>
  <tr>
    <th>Month</th>
    <th><h5>Revenue</h5></th> <!-- Incorrect placement of h5 inside th -->
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

Corrected HTML:

<h5>Revenue per month</h5>
<table>
  <tr>
    <th>Month</th>
    <th>Revenue</th>
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

In the corrected example, the issue is fixed by removing the h5 element from the th element. If you need to style the text inside the th element differently, you can achieve that via CSS without nesting heading elements inside table cell elements.

To fix the W3C HTML Validator issue stating that a heading element like h1, h2, h3, h4, h5 or h6 must not appear as a descendant of the th element, you need to ensure that the HTML structure follows the specifications where a heading element (h1 to h6) is not placed within a table cell element like th.

Here’s an example of what might be causing the issue and how you can correct it:

Incorrect HTML:

<table>
  <tr>
    <th>Month</th>
    <th><h6>Revenue</h6></th> <!-- Incorrect placement of h6 inside th -->
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

Corrected HTML:

<h4>Revenue per month</h4>
<table>
  <tr>
    <th>Month</th>
    <th>Revenue</th>
  </tr>
  <tr>
    <td>January</td>
    <td>$500</td>
  </tr>
</table>

In the corrected example, the issue is fixed by removing the h6 element from the th element. If you need to style the text inside the th element differently, you can achieve that via CSS without nesting heading elements inside table cell elements.

An element like <h1>, <h2>, etc., used to define a heading, does not accept the button role.

The following HTML code is invalid because the <h2> element can’t have role="button"

<h2 role="button">Some heading</h2>

Instead, you can nest the <h2> inside a <div> with that role. In this case however, browsers automatically apply role presentation to all descendant elements of any button element as it is a role that does not support semantic children.

<div role="button">
  <h2>Some heading</h2>
</div>

The HTML <h1> to <h6> elements represent headings for the different sections of a document, where <h1> is the highest section and <h6> is the lowest. Headings are specially important on screen readers as they give a quick overview of the contents of the different sections in the web page, so although it’s technically correct (not an error) to use a <h1> in this way:

<section class="about">
  <article>
    <h1>Article heading</h1>
    <p>Lorem</p>
  </article>
</section>

this will raise a warning as it would be preferrable for example to leave the <h1> for the heading of the <section>, and <h2> for the heading of the article, like this:

<section class="about">
  <h1>About heading</h1>
  <article>
    <h2>Article heading</h2>
	<p>Lorem</p>
  </article>
</section>

The <h1> through <h6> elements are headings for the sections with which they are associated. They should not be empty, for example <h1></h1> is invalid.

A heading element (h1, h2, h3, etc.) can’t be nested inside another heading element.

Here’s an example of invalid HTML code:

<h1>Main heading
  <h2>Sub heading</h2>
</h1>

To fix this issue, you should ensure that each heading element is properly nested within the document hierarchy. Headings should only be used to indicate the structure of your content, not to style it.

Here’s an example of valid HTML code that properly uses heading elements:

<main>
  <h1>Main heading</h1>
  <section>
    <h2>Section heading</h2>
    <p>Paragraph content</p>
  </section>
</main>

In this example, the heading elements are used to denote the structure of the document, with the h1 element indicating the highest level heading and the h2 element indicating a subheading within a section. Notice that in the valid example, each heading element is only used once and is not nested within another heading element.

Some times this can be caused by a typo in the end tag for a heading, for example:

<h3>Meet the Feebles<h3>

In order to fix this issue, the end tag should be </h3> in the example above.

A <table> contains an incoherent number of cells on one of its columns. Check the structure of the table to find the invalid column.

Example of a valid table that defines in its header that the first column is 2 cells wide:

<table>
  <thead>
    <tr>
      <th colspan="2">The table header</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>The table body</td>
      <td>with two columns</td>
    </tr>
  </tbody>
</table>

This same table with an empty body will be invalid because the table header cannot match any body columns:

<table>
  <thead>
    <tr>
      <th colspan="2">The table header</th>
    </tr>
  </thead>
  <tbody>
  </tbody>
</table>