HTML colspan Attribute

The colspan attribute on a table cell element specifies the number of columns this cell should span, i.e., extend. Elements that accept this attribute include <td>, and <th>.

Example

#

A colspan attribute on a <td> element.
The last row extends to multiple columns.

Investor Amount
Joel Nais $250
Tom Simpson $300
Greta Waltz $100
Total amount invested: $650
<style>
  table.tb {width:300px;border-collapse:collapse;}
  .tb th {background-color:lightblue;}
  .tb th, .tb td {border:solid 1px #777;padding:5px;}
</style>

<table class="tb">
   <tr> 
      <th>Investor</th>
      <th>Amount</th>
   </tr>
   <tr> 
      <td>Joel Nais</td>
      <td>$250</td>
   </tr>
   <tr> 
      <td>Tom Simpson</td>
      <td>$300</td>
   </tr>
   <tr> 
      <td>Greta Waltz</td>
      <td>$100</td>
   </tr>
   <tr> 
      <td colspan="2">Total amount invested: <b>$650</b></td>
   </tr>
</table>

For additional details see our HTML td colspan Reference.


Using colspan

The colspan attribute specifies the number of columns a table cell should span, i.e. extend.

A colspan value of "0" will span until the last column in the current <colgroup> (column group).

If no colgroup is defined it falls back to colspan="1", which is the same as no colspan at all.


Syntax

<tagname colspan="number">

Values

#

Value Description
number Number of columns the table cell should span.

Elements that accept colspan

These table elements accept the colspan attribute.

Elements Description
<td> Creates a standard table cell -- see example above
<th> Creates a table header cell.

<th> with colspan

A <th> tag with a colspan attribute.
The first header cell spans two columns.

Name Country
Denice Templeman Italy
Paulo Cornell USA
Maria Larsson Sweden
<style>
  table.tbl {width:300px;border-collapse:collapse;}
  .tbl th, .tbl td {border:solid 1px #777;padding:5px;}
  .tbl th {background-color: lightblue;}
</style>

<table class="tbl">
  <tr>
    <th colspan="2">Name</th> 
    <th>Country</th>
  </tr>
  <tr>
    <td>Denice</td>
    <td>Templeman</td>
    <td>Italy</td>
  </tr>
  <tr>
    <td>Paulo</td>
    <td>Cornell</td>
    <td>USA</td>
  </tr>
  <tr>
    <td>Maria</td>
    <td>Larsson</td>
    <td>Sweden</td>
  </tr>
</table>

For additional details see our HTML th colspan Reference.


Browser support

Here is when colspan support started for each browser:

Chrome
1.0 Sep 2008
Firefox
1.0 Sep 2002
IE/Edge
1.0 Aug 1995
Opera
1.0 Jan 2006
Safari
1.0 Jan 2003

You may also like



Guides