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.
These templates for a landing page and a documentation page are built from some of the components of the U.S. Web Design System. Each of these pages is flexible; you can add or remove components or sub-components to suit your needs. These templates are great starting point for prototyping or for trying the Design System to see if they’re a good fit for you.
Template 1: Landing page
A landing page is intended to provide someone’s first impression of your agency or program. Often, they’ll arrive from somewhere else without much context, like a search result or a colleague’s email. So a landing page needs to be clear, engaging, and contextualizing.
<aclass="usa-skipnav"href="#main-content">Skip to main content</a><sectionclass="usa-banner"><divclass="usa-accordion"><headerclass="usa-banner-header"><divclass="usa-grid usa-banner-inner"><imgsrc="/assets/img/favicons/favicon-57.png"alt="U.S. flag"/><p>An official website of the United States government</p><buttonclass="usa-accordion-button usa-banner-button"aria-expanded="false"aria-controls="gov-banner"><spanclass="usa-banner-button-text">Here's how you know</span></button></div></header><divclass="usa-banner-content usa-grid usa-accordion-content"id="gov-banner"><divclass="usa-banner-guidance-gov usa-width-one-half"><imgclass="usa-banner-icon usa-media_block-img"src="/assets/img/icon-dot-gov.svg"alt="Dot gov"/><divclass="usa-media_block-body"><p><strong>The .gov means it’s official.</strong><br/>
Federal government websites often end in .gov or .mil. Before
sharing sensitive information, make sure you’re on a federal
government site.
</p></div></div><divclass="usa-banner-guidance-ssl usa-width-one-half"><imgclass="usa-banner-icon usa-media_block-img"src="/assets/img/icon-https.svg"alt="Https"/><divclass="usa-media_block-body"><p><strong>The site is secure.</strong><br/>
The <strong>https://</strong> ensures that you are connecting to the
official website and that any information you provide is encrypted
and transmitted securely.
</p></div></div></div></div></section><headerclass="usa-header usa-header-extended"role="banner"><divclass="usa-navbar"><divclass="usa-logo"id="extended-logo"><emclass="usa-logo-text"><ahref="/"title="Home"aria-label="Home">
Department of Web Design
</a></em></div><buttonclass="usa-menu-btn">Menu</button></div><navrole="navigation"class="usa-nav"><divclass="usa-nav-inner"><buttonclass="usa-nav-close"><imgsrc="/assets/img/close.svg"alt="close"/></button><ulclass="usa-nav-primary usa-accordion"><li><buttonclass="usa-accordion-button usa-nav-link"aria-expanded="false"aria-controls="extended-nav-section-one"><span>Section title</span></button><ulid="extended-nav-section-one"class="usa-nav-submenu"><li><ahref="#">Subsection title</a></li><li><ahref="#">Subsection title</a></li><li><ahref="#">Subsection title</a></li></ul></li><li><buttonclass="usa-accordion-button usa-nav-link"aria-expanded="false"aria-controls="extended-nav-section-two"><span>Simple terms</span></button><ulid="extended-nav-section-two"class="usa-nav-submenu"><li><ahref="#">Subsection title</a></li><li><ahref="#">Subsection title</a></li><li><ahref="#">Subsection title</a></li></ul></li><li><aclass="usa-nav-link"href="javascript:void(0)"><span>Distinct from each other</span></a></li></ul><divclass="usa-nav-secondary"><formclass="usa-search usa-search-small js-search-form"><divrole="search"><labelclass="usa-sr-only"for="extended-search-field-small">Search small</label><inputid="extended-search-field-small"type="search"name="search"/><buttontype="submit"><spanclass="usa-sr-only">Search</span></button></div></form><ulclass="usa-unstyled-list usa-nav-secondary-links"><liclass="js-search-button-container"><buttonclass="usa-header-search-button js-search-button">
Search
</button></li><li><ahref="">
Secondary priority link
</a></li><li><ahref="">
Easy to comprehend
</a></li></ul></div></div></nav></header><divclass="usa-overlay"></div><mainid="main-content"><sectionclass="usa-hero"><divclass="usa-grid"><divclass="usa-hero-callout usa-section-dark"><h2><spanclass="usa-hero-callout-alt">Hero callout:</span>
Call attention to a current priority
</h2><p>
Support the callout with some short explanatory text. You don't need
more than a couple of sentences.
</p><aclass="usa-button"href="javascript:void(0)">Learn about what we do</a></div></div></section><sectionclass="usa-grid usa-section"><divclass="usa-width-one-third"><h2>A tagline highlights your approach</h2></div><divclass="usa-width-two-thirds"><p>
The tagline should inspire confidence and interest, focusing on the
value that your overall approach offers to your audience. Use a heading
typeface and keep your tagline to just a few words, and don’t confuse or
mystify.
</p><p>
Use the right side of the grid to explain the tagline a bit more. What
are your goals? How do you do your work? Write in the present tense, and
stay brief here. People who are interested can find details on internal
pages.
</p></div></section><sectionclass="usa-section usa-section-dark usa-graphic_list"><divclass="usa-grid usa-graphic_list-row"><divclass="usa-width-one-half usa-media_block"><imgclass="usa-media_block-img"src="/assets/img/circle-124.png"alt="Alt text"/><divclass="usa-media_block-body"><h3>Graphic headings can vary.</h3><p>
Graphic headings can be used a few different ways, depending on what
your landing page is for. Highlight your values, specific program
areas, or results.
</p></div></div><divclass="usa-width-one-half usa-media_block"><imgclass="usa-media_block-img"src="/assets/img/circle-124.png"alt="Alt text"/><divclass="usa-media_block-body"><h3>Stick to 6 or fewer words.</h3><p>
Keep body text to about 30. They can be shorter, but try to be
somewhat balanced across all four. It creates a clean appearance
with good spacing.
</p></div></div></div><divclass="usa-grid usa-graphic_list-row"><divclass="usa-width-one-half usa-media_block"><imgclass="usa-media_block-img"src="/assets/img/circle-124.png"alt="Alt text"/><divclass="usa-media_block-body"><h3>Never highlight anything without a goal.</h3><p>
For anything you want to highlight here, understand what your users
know now, and what activity or impression you want from them after
they see it.
</p></div></div><divclass="usa-width-one-half usa-media_block"><imgclass="usa-media_block-img"src="/assets/img/circle-124.png"alt="Alt text"/><divclass="usa-media_block-body"><h3>Could also have 2 or 6.</h3><p>
In addition to your goal, find out your users’ goals. What do they
want to know or do that supports your mission? Use these headings to
show those.
</p></div></div></div></section><sectionclass="usa-section"><divclass="usa-grid"><h2>Section heading</h2><pclass="usa-font-lead">
Everything up to this point should help people understand your agency or
project: who you are, your goal or mission, and how you approach it. Use
this section to encourage them to act. Describe why they should get in
touch here, and use an active verb on the button below. “Get in touch,”
“Learn more,” and so on.
</p><aclass="usa-button usa-button-big"href="#">Call to action</a></div></section></main>
When to use
If you are introducing a new program to the public through a marketing or publicity campaign, a landing page is a good place to point links at. It can build on the minimal copy of a campaign without overwhelming readers.
The landing page can be a good model for a homepage. But do some research first. What do you have to say? What do your users need to know? Figure these things out. It’s important to know what you have to say about your organization before you settle on a homepage design.
When to avoid
Don’t use a landing page for standard internal page content. The same things that help people understand basics quickly can become distracting for people who are looking for more depth.
Don’t try to include forms or side navigation in a page like this. Those are visually complex components, and a landing page works best without too much complexity.
Guidance
If you are using the landing page to encourage users to follow a primary call to action, consider getting rid of the header. The less there is to distract people from the most important task, the more often they will do it.
For guidance on specific components, see the pages for the individual components.
Do not create extra content just to fill the template. You can remove individual components (such as the media block) or sub-components (such as individual menu items in the header) from the template as you implement it. This version gives you a broad idea of the number of things your landing page could include. But never make a page more complex than you need to. If you’re unsure, interview users to find out what they need to know.
Components used in this template
Extended header
Hero feature
Typography — Merriweather headings and Source Sans Pro body
Graphic list
Media block
Grid
Headings
Buttons
Medium footer
Component definitions
Hero feature: Hero features are used at the top of your landing page to help set the tone for the content of your site and to help users understand what your brand is all about. The Hero feature offers a callout which provides a high-level overview of the content on the site and will often reference the Hero image that sits behind it.
Graphic list: The Graphic list is used to showcase a number of related items and their respective images in a grid pattern.
Template 2: Documentation page
A documentation page presents information on a certain theme, topic, or idea. People often arrive here after visiting the landing page or after searching for a specific piece of information, so documentation pages don’t need to provide as much contextualizing information as more introductory pages would. The copy should be clear, focused, and concise.
<aclass="usa-skipnav"href="#main-content">Skip to main content</a><sectionclass="usa-banner"><divclass="usa-accordion"><headerclass="usa-banner-header"><divclass="usa-grid usa-banner-inner"><imgsrc="/assets/img/favicons/favicon-57.png"alt="U.S. flag"/><p>An official website of the United States government</p><buttonclass="usa-accordion-button usa-banner-button"aria-expanded="false"aria-controls="gov-banner"><spanclass="usa-banner-button-text">Here's how you know</span></button></div></header><divclass="usa-banner-content usa-grid usa-accordion-content"id="gov-banner"><divclass="usa-banner-guidance-gov usa-width-one-half"><imgclass="usa-banner-icon usa-media_block-img"src="/assets/img/icon-dot-gov.svg"alt="Dot gov"/><divclass="usa-media_block-body"><p><strong>The .gov means it’s official.</strong><br/>
Federal government websites often end in .gov or .mil. Before
sharing sensitive information, make sure you’re on a federal
government site.
</p></div></div><divclass="usa-banner-guidance-ssl usa-width-one-half"><imgclass="usa-banner-icon usa-media_block-img"src="/assets/img/icon-https.svg"alt="Https"/><divclass="usa-media_block-body"><p><strong>The site is secure.</strong><br/>
The <strong>https://</strong> ensures that you are connecting to the
official website and that any information you provide is encrypted
and transmitted securely.
</p></div></div></div></div></section><headerclass="usa-header usa-header-basic"role="banner"><divclass="usa-nav-container"><divclass="usa-navbar"><divclass="usa-logo"id="basic-logo"><emclass="usa-logo-text"><ahref="/"title="Home"aria-label="Home">
Department of Web Design
</a></em></div><buttonclass="usa-menu-btn">Menu</button></div><navrole="navigation"class="usa-nav"><buttonclass="usa-nav-close"><imgsrc="/assets/img/close.svg"alt="close"/></button><ulclass="usa-nav-primary usa-accordion"><li><buttonclass="usa-accordion-button usa-nav-link"aria-expanded="false"aria-controls="basic-nav-section-one"><span>Section title</span></button><ulid="basic-nav-section-one"class="usa-nav-submenu"><li><ahref="#">Subsection title</a></li><li><ahref="#">Subsection title</a></li><li><ahref="#">Subsection title</a></li></ul></li><li><buttonclass="usa-accordion-button usa-nav-link"aria-expanded="false"aria-controls="basic-nav-section-two"><span>Simple terms</span></button><ulid="basic-nav-section-two"class="usa-nav-submenu"><li><ahref="#">Subsection title</a></li><li><ahref="#">Subsection title</a></li><li><ahref="#">Subsection title</a></li></ul></li><li><aclass="usa-nav-link"href="javascript:void(0)"><span>Distinct from each other</span></a></li></ul><formclass="usa-search usa-search-small "><divrole="search"><labelclass="usa-sr-only"for="basic-search-field-small">Search small</label><inputid="basic-search-field-small"type="search"name="search"/><buttontype="submit"><spanclass="usa-sr-only">Search</span></button></div></form></nav></div></header><divclass="usa-overlay"></div><mainclass="usa-grid usa-section usa-content usa-layout-docs"id="main-content"><asideclass="usa-width-one-fourth usa-layout-docs-sidenav"><nav><ulclass="usa-sidenav-list"><li><ahref="">
Parent link
</a></li><li><ahref=""class="usa-current">
Current page
</a><ulclass="usa-sidenav-sub_list"><li><ahref="">
Child link
</a></li><li><ahref=""class="usa-current">
Child link
</a><ulclass="usa-sidenav-sub_list"><li><ahref="">
Grandchild link
</a></li><li><ahref="">
Grandchild link
</a></li><li><ahref=""class="usa-current">
Grandchild link
</a></li><li><ahref="">
Grandchild link
</a></li></ul></li><li><ahref="">
Child link
</a></li><li><ahref="">
Child link
</a></li><li><ahref="">
Child link
</a></li></ul></li><li><ahref="">
Parent link
</a></li></ul></nav></aside><divclass="usa-width-three-fourths usa-layout-docs-main_content"><h1>Page heading (h1)</h1><pclass="usa-font-lead">
The page heading communicates the main focus of the page. Make your page
heading descriptive and keep it succinct.
</p><h2id="section-heading-h2">Section heading (h2)</h2><p>
These headings introduce, respectively, sections and subsections within
your body copy. As you create these headings, follow the same guidelines
that you use when writing section headings: Be succinct, descriptive, and
precise.
</p><h3id="section-heading-h3">Subsection heading (h3)</h3><p>
The particulars of your body copy will be determined by the topic of your
page. Regardless of topic, it’s a good practice to follow the inverted
pyramid structure when writing copy: Begin with the information that’s
most important to your users and then present information of less
importance.
</p><p>
Keep each section and subsection focused — a good approach is to include
one theme (topic) per section.
</p><h4id="section-heading-h4">Subsection heading (h4)</h4><p>
Use the side navigation menu to help your users quickly skip to different
sections of your page. The menu is best suited to displaying a hierarchy
with one to three levels and, as we mentioned, to display the
sub-navigation of a given page.
</p><p>
Read the full documentation on our side navigation on the component page.
</p></div></main>
When to use
If you’re presenting detailed information on a specific topic or theme that has already been contextualized by a landing page. Some topics that can be nicely represented on this type of page include guides or how-tos, technical documentation, and program descriptions — in short, any subject that requires in-depth explanation.
When to avoid
Don’t use a documentation page to introduce your users to your agency or organization — the landing page is better suited to that purpose. The level of detail present on documentation pages can overwhelm users who are just becoming acquainted with your organization.
Guidance
Use a precise headline to quickly communicate your page’s purpose. If the page content is especially complex, you may consider using a subheadline to further clarify its meaning.
Write concise copy. Favor short sentences (and paragraphs) over longer ones, and use straightforward language, avoiding jargon. Remember, copy blocks don’t need to be long to be comprehensive.
For guidance on specific components, see the page for the individual components.
Components used in this template
Basic header
Typography — Merriweather headings and Source Sans Pro body