We released USWDS v2 in April 2019. For current information on USWDS,
visit designsystem.digital.gov.
This USWDS v1 site is archived. It is read-only, so use it for v1 only.
An official website of the United States government
The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you're on a federal government site.
The site is secure. The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.
Statement adopted by the Continental Congress declaring independence
from the British Empire.
1776
Bill of Rights
The first ten amendments of the U.S. Constitution guaranteeing rights
and freedoms.
1791
Declaration of Sentiments
A document written during the Seneca Falls Convention outlining the
rights that American women should be entitled to as citizens.
1848
Emancipation Proclamation
An executive order granting freedom to slaves in designated southern
states.
1863
Borderless table: A borderless table can be useful when you want the
information to feel more a part of the text it accompanies and extends.
Document Title
Description
Year
Declaration of Independence
Statement adopted by the Continental Congress declaring independence
from the British Empire.
1776
Bill of Rights
The first ten amendments of the U.S. Constitution guaranteeing rights
and freedoms.
1791
Declaration of Sentiments
A document written during the Seneca Falls Convention outlining the
rights that American women should be entitled to as citizens.
1848
Emancipation Proclamation
An executive order granting freedom to slaves in designated southern
states.
1863
<table><caption>
Bordered table
</caption><thead><tr><thscope="col">Document title</th><thscope="col">Description</th><thscope="col">Year</th></tr></thead><tbody><tr><thscope="row">Declaration of Independence</th><td>
Statement adopted by the Continental Congress declaring independence
from the British Empire.
</td><td>1776</td></tr><tr><thscope="row">Bill of Rights</th><td>
The first ten amendments of the U.S. Constitution guaranteeing rights
and freedoms.
</td><td>1791</td></tr><tr><thscope="row">Declaration of Sentiments</th><td>
A document written during the Seneca Falls Convention outlining the
rights that American women should be entitled to as citizens.
</td><td>1848</td></tr><tr><thscope="row">Emancipation Proclamation</th><td>
An executive order granting freedom to slaves in designated southern
states.
</td><td>1863</td></tr></tbody></table><tableclass="usa-table-borderless"><caption>
Borderless table: A borderless table can be useful when you want the
information to feel more a part of the text it accompanies and extends.
</caption><thead><tr><thscope="col">Document Title</th><thscope="col">Description</th><thscope="col">Year</th></tr></thead><tbody><tr><thscope="row">Declaration of Independence</th><td>
Statement adopted by the Continental Congress declaring independence
from the British Empire.
</td><td>1776</td></tr><tr><thscope="row">Bill of Rights</th><td>
The first ten amendments of the U.S. Constitution guaranteeing rights
and freedoms.
</td><td>1791</td></tr><tr><thscope="row">Declaration of Sentiments</th><td>
A document written during the Seneca Falls Convention outlining the
rights that American women should be entitled to as citizens.
</td><td>1848</td></tr><tr><thscope="row">Emancipation Proclamation</th><td>
An executive order granting freedom to slaves in designated southern
states.
</td><td>1863</td></tr></tbody></table>
Accessibility
Simple tables can have two levels of headers. Each header cell should have scope="col" or scope="row".
Complex tables are tables with more than two levels of headers. Each header should be given a unique id and each data cell should have a headers attribute with each related header cell’s id listed.
When adding a title to a table, include it in a <caption> tag inside of the <table> element.
Usability
When to use
When you need tabular information, such as statistical data.
When to consider something else
Depending on the type of content, consider using other presentation formats such as definition lists or hierarchical lists.
Guidance
Tables are great at displaying tabular data. Minimal visual styling helps surface this information more easily.