Components

Identifier

The identifier communicates a site’s parent agency and displays agency links required by federal laws and policies.

Default
Default (Spanish)
Multiple parents and logos
Multiple parents and logos (Spanish)
No logos
Taxpayer disclaimer

domain.gov

An official website of the <Parent agency>. Produced and published at taxpayer expense.

Looking for U.S. government information and services?
Visit USA.gov
Taxpayer disclaimer (Spanish)

domain.gov

Un sitio web oficial de <Parent agency>. Producido y publicado con dinero de los contribuyentes de impuestos.

¿Necesita información y servicios del Gobierno?
Visite USA.gov en Español
<h6>Default</h6>

  

<div class="usa-identifier">
  <section
    class="usa-identifier__section usa-identifier__section--masthead"
    aria-label="Agency identifier">
    <div class="usa-identifier__container"><div class="usa-identifier__logos">
        <a href="javascript:void(0);" class="usa-identifier__logo">
          <img
            class="usa-identifier__logo-img"
            
            src="/assets/img/circle-gray-20.svg"
            
            
            alt="&lt;Parent agency&gt; logo"
            
            role="img">
        </a></div><div class="usa-identifier__identity" aria-label="Agency description">
        <p class="usa-identifier__identity-domain">domain.gov</p>
        <p class="usa-identifier__identity-disclaimer">An official website of the <a href="javascript:void(0);">&lt;Parent agency&gt;</a></p>
      </div>
    </div>
  </section>
  <nav class="usa-identifier__section usa-identifier__section--required-links" aria-label="Important links">
    <div class="usa-identifier__container">
      <ul class="usa-identifier__required-links-list">
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link">About &lt;Parent shortname&gt;</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link">Accessibility support</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">FOIA requests</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">No FEAR Act data</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Office of the Inspector General</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Performance reports</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Privacy policy</a>
        </li>
      </ul>
    </div>
  </nav>
  <section class="usa-identifier__section usa-identifier__section--usagov" aria-label="U.S. government information and services">
    <div class="usa-identifier__container">
      <div class="usa-identifier__usagov-description">Looking for U.S. government information and services?</div>
      <a href="https://www.usa.gov/" class="usa-link">Visit USA.gov</a>
    </div>
  </section>
  </div>




<h6>Default (Spanish)</h6>

  

<div class="usa-identifier">
  <section
    class="usa-identifier__section usa-identifier__section--masthead"
    aria-label="Identificador de la agencia">
    <div class="usa-identifier__container"><div class="usa-identifier__logos">
        <a href="javascript:void(0);" class="usa-identifier__logo">
          <img
            class="usa-identifier__logo-img"
            
            src="/assets/img/circle-gray-20.svg"
            
            
            alt="Logo de la &lt;Parent agency&gt;"
            
            role="img">
        </a></div><div class="usa-identifier__identity" aria-label="Descripción de la agencia">
        <p class="usa-identifier__identity-domain">domain.gov</p>
        <p class="usa-identifier__identity-disclaimer">Un sitio web oficial de <a href="javascript:void(0);">&lt;Parent agency&gt;</a></p>
      </div>
    </div>
  </section>
  <nav class="usa-identifier__section usa-identifier__section--required-links" aria-label="Enlaces importantes">
    <div class="usa-identifier__container">
      <ul class="usa-identifier__required-links-list">
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link">Acerca de &lt;Parent shortname&gt;</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link">Soporte de accesibilidad</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">Solicitud a través de FOIA</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">Datos de la ley No FEAR</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Oficina del Inspector General</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Informes de desempeño</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Política de privacidad</a>
        </li>
      </ul>
    </div>
  </nav>
  <section class="usa-identifier__section usa-identifier__section--usagov" aria-label="Información y servicios del Gobierno de EE. UU.">
    <div class="usa-identifier__container">
      <div class="usa-identifier__usagov-description">¿Necesita información y servicios del Gobierno?</div>
      <a href="https://www.usa.gov/espanol/" class="usa-link">Visite USA.gov en Español</a>
    </div>
  </section>
  </div>




<h6>Multiple parents and logos</h6>

  

<div class="usa-identifier">
  <section
    class="usa-identifier__section usa-identifier__section--masthead"
    aria-label="Agency identifier">
    <div class="usa-identifier__container"><div class="usa-identifier__logos">
        <a href="javascript:void(0);" class="usa-identifier__logo">
          <img
            class="usa-identifier__logo-img"
            
            src="/assets/img/circle-gray-20.svg"
            
            
            alt="&lt;Parent agency&gt; logo"
            
            role="img">
        </a>
        <a href="javascript:void(0);" class="usa-identifier__logo">
          <img
            class="usa-identifier__logo-img"
            
            src="/assets/img/circle-gray-20.svg"
            
            
            alt="&lt;Other agency&gt; logo"
            
            role="img">
        </a></div><div class="usa-identifier__identity" aria-label="Agency description">
        <p class="usa-identifier__identity-domain">domain.gov</p>
        <p class="usa-identifier__identity-disclaimer">An official website of the <a href="javascript:void(0);">&lt;Parent agency&gt;</a> and the <a href="javascript:void(0);">&lt;Other agency&gt;</a></p>
      </div>
    </div>
  </section>
  <nav class="usa-identifier__section usa-identifier__section--required-links" aria-label="Important links">
    <div class="usa-identifier__container">
      <ul class="usa-identifier__required-links-list">
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link">About &lt;Parent shortname&gt;</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link">Accessibility support</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">FOIA requests</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">No FEAR Act data</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Office of the Inspector General</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Performance reports</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Privacy policy</a>
        </li>
      </ul>
    </div>
  </nav>
  <section class="usa-identifier__section usa-identifier__section--usagov" aria-label="U.S. government information and services">
    <div class="usa-identifier__container">
      <div class="usa-identifier__usagov-description">Looking for U.S. government information and services?</div>
      <a href="https://www.usa.gov/" class="usa-link">Visit USA.gov</a>
    </div>
  </section>
  </div>




<h6>Multiple parents and logos (Spanish)</h6>

  

<div class="usa-identifier">
  <section
    class="usa-identifier__section usa-identifier__section--masthead"
    aria-label="Identificador de la agencia">
    <div class="usa-identifier__container"><div class="usa-identifier__logos">
        <a href="javascript:void(0);" class="usa-identifier__logo">
          <img
            class="usa-identifier__logo-img"
            
            src="/assets/img/circle-gray-20.svg"
            
            
            alt="Logo de la &lt;Parent agency&gt;"
            
            role="img">
        </a>
        <a href="javascript:void(0);" class="usa-identifier__logo">
          <img
            class="usa-identifier__logo-img"
            
            src="/assets/img/circle-gray-20.svg"
            
            
            alt="Logo de la &lt;Other agency&gt;"
            
            role="img">
        </a></div><div class="usa-identifier__identity" aria-label="Descripción de la agencia">
        <p class="usa-identifier__identity-domain">domain.gov</p>
        <p class="usa-identifier__identity-disclaimer">Un sitio web oficial de <a href="javascript:void(0);">&lt;Parent agency&gt;</a> y <a href="javascript:void(0);">&lt;Other agency&gt;</a></p>
      </div>
    </div>
  </section>
  <nav class="usa-identifier__section usa-identifier__section--required-links" aria-label="Enlaces importantes">
    <div class="usa-identifier__container">
      <ul class="usa-identifier__required-links-list">
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link">Acerca de &lt;Parent shortname&gt;</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link">Soporte de accesibilidad</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">Solicitud a través de FOIA</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">Datos de la ley No FEAR</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Oficina del Inspector General</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Informes de desempeño</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Política de privacidad</a>
        </li>
      </ul>
    </div>
  </nav>
  <section class="usa-identifier__section usa-identifier__section--usagov" aria-label="Información y servicios del Gobierno de EE. UU.">
    <div class="usa-identifier__container">
      <div class="usa-identifier__usagov-description">¿Necesita información y servicios del Gobierno?</div>
      <a href="https://www.usa.gov/espanol/" class="usa-link">Visite USA.gov en Español</a>
    </div>
  </section>
  </div>




<h6>No logos</h6>

  

<div class="usa-identifier">
  <section
    class="usa-identifier__section usa-identifier__section--masthead"
    aria-label="Agency identifier">
    <div class="usa-identifier__container"><div class="usa-identifier__identity" aria-label="Agency description">
        <p class="usa-identifier__identity-domain">domain.gov</p>
        <p class="usa-identifier__identity-disclaimer">An official website of the <a href="javascript:void(0);">&lt;Parent agency&gt;</a></p>
      </div>
    </div>
  </section>
  <nav class="usa-identifier__section usa-identifier__section--required-links" aria-label="Important links">
    <div class="usa-identifier__container">
      <ul class="usa-identifier__required-links-list">
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link">About &lt;Parent shortname&gt;</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link">Accessibility support</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">FOIA requests</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">No FEAR Act data</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Office of the Inspector General</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Performance reports</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Privacy policy</a>
        </li>
      </ul>
    </div>
  </nav>
  <section class="usa-identifier__section usa-identifier__section--usagov" aria-label="U.S. government information and services">
    <div class="usa-identifier__container">
      <div class="usa-identifier__usagov-description">Looking for U.S. government information and services?</div>
      <a href="https://www.usa.gov/" class="usa-link">Visit USA.gov</a>
    </div>
  </section>
  </div>




<h6>Taxpayer disclaimer</h6>

  

<div class="usa-identifier">
  <section
    class="usa-identifier__section usa-identifier__section--masthead"
    aria-label="Agency identifier">
    <div class="usa-identifier__container"><div class="usa-identifier__logos">
        <a href="javascript:void(0);" class="usa-identifier__logo">
          <img
            class="usa-identifier__logo-img"
            
            src="/assets/img/circle-gray-20.svg"
            
            
            alt="&lt;Parent agency&gt; logo"
            
            role="img">
        </a></div><div class="usa-identifier__identity" aria-label="Agency description">
        <p class="usa-identifier__identity-domain">domain.gov</p>
        <p class="usa-identifier__identity-disclaimer">An official website of the <a href="javascript:void(0);">&lt;Parent agency&gt;</a>. Produced and published at taxpayer expense.</p>
      </div>
    </div>
  </section>
  <nav class="usa-identifier__section usa-identifier__section--required-links" aria-label="Important links">
    <div class="usa-identifier__container">
      <ul class="usa-identifier__required-links-list">
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link">About &lt;Parent shortname&gt;</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link">Accessibility support</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">FOIA requests</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">No FEAR Act data</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Office of the Inspector General</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Performance reports</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Privacy policy</a>
        </li>
      </ul>
    </div>
  </nav>
  <section class="usa-identifier__section usa-identifier__section--usagov" aria-label="U.S. government information and services">
    <div class="usa-identifier__container">
      <div class="usa-identifier__usagov-description">Looking for U.S. government information and services?</div>
      <a href="https://www.usa.gov/" class="usa-link">Visit USA.gov</a>
    </div>
  </section>
  </div>




<h6>Taxpayer disclaimer (Spanish)</h6>

  

<div class="usa-identifier">
  <section
    class="usa-identifier__section usa-identifier__section--masthead"
    aria-label="Identificador de la agencia">
    <div class="usa-identifier__container"><div class="usa-identifier__logos">
        <a href="javascript:void(0);" class="usa-identifier__logo">
          <img
            class="usa-identifier__logo-img"
            
            src="/assets/img/circle-gray-20.svg"
            
            
            alt="Logo de la &lt;Parent agency&gt;"
            
            role="img">
        </a></div><div class="usa-identifier__identity" aria-label="Descripción de la agencia">
        <p class="usa-identifier__identity-domain">domain.gov</p>
        <p class="usa-identifier__identity-disclaimer">Un sitio web oficial de <a href="javascript:void(0);">&lt;Parent agency&gt;</a>. Producido y publicado con dinero de los contribuyentes de impuestos.</p>
      </div>
    </div>
  </section>
  <nav class="usa-identifier__section usa-identifier__section--required-links" aria-label="Enlaces importantes">
    <div class="usa-identifier__container">
      <ul class="usa-identifier__required-links-list">
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link">Acerca de &lt;Parent shortname&gt;</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link">Soporte de accesibilidad</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">Solicitud a través de FOIA</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);"
            class="usa-identifier__required-link usa-link">Datos de la ley No FEAR</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Oficina del Inspector General</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Informes de desempeño</a>
        </li>
        <li class="usa-identifier__required-links-item">
          <a href="javascript:void(0);" class="usa-identifier__required-link usa-link">Política de privacidad</a>
        </li>
      </ul>
    </div>
  </nav>
  <section class="usa-identifier__section usa-identifier__section--usagov" aria-label="Información y servicios del Gobierno de EE. UU.">
    <div class="usa-identifier__container">
      <div class="usa-identifier__usagov-description">¿Necesita información y servicios del Gobierno?</div>
      <a href="https://www.usa.gov/espanol/" class="usa-link">Visite USA.gov en Español</a>
    </div>
  </section>
  </div>

When to use the identifier component

  • To identify a site's parent agency. The identifier is a complement to the USWDS banner. Use the identifier to tell users what agency is responsible for your website.
  • To display links required by federal laws and policies. The identifier includes links required on all government sites.

When to consider something else

  • Any time it would be misleading. The identifier should be used to reduce confusion. Avoid using the identifier on any site meant only for testing or otherwise not meant to be identified as an official government website.
  • Redundant content. Don't add the identifier without removing any duplicate links from your existing site footer. Favor the common links and content in the identifier over any equivalent content in your site footer.

Usability guidance

  • Use the identifier component for required links. If your site already includes the federally required links in its site footer, remove them in favor of the links in the identifier. This assures that site visitors find the required links in a consistent location from site to site.
  • Display the parent agency logo, not the product logo. The identifier is meant to identify a website's parent agency as a complement to the site footer. Site-specific logos, like a product logo, should be in the site footer, not the identifier.
  • Display multiple parents and logos in hierarchical order. If a site has more than one parent agency, you may display a reference and a logo for each parent in hierarchical order, highest first. For example,"An official website of [Grandparent Department] and [Parent Agency]".
  • Avoid distraction. The identifier appears on every page of your site. Choose background colors that fit with your site theme and avoid color combinations that draw excessive attention to the identifier.
  • Keep the text up-to-date. Use the most current version of the identifier.

Accessibility

  • Use proper landmarks for each identifier section. Each identifier section should be either a section or a nav, and include an appropriate aria-label property.
  • Add an alt attribute to each logo image. Use [Agency shortname] logo as the alt text for each logo image you add.
  • Use image role for any SVG images. Use role="img" with any SVG logo image.

Implementation

  • Except where noted, use the entire component without deletions or additions. With rare exceptions, if you use the identifier, include the entire identifier. That is, don't delete sections or required links or change any link text beyond the customizations mentioned in the implementation section.
  • Use a background color darker than that of the footer. Use color to anchor the identifier to the bottom of the page and distinguish it from other site content. Use primary or base family background colors of grade 80 or higher, or black.
  • Use an SVG logo if possible. Ensure the logo is high resolution. We recommend using the SVG version of any logo if you have one. Otherwise, use an image that's at least 120 pixels tall.
  • Use logos intended for dark backgrounds if possible. The identifier has a dark background. If your agency has a version of its logo intended for dark backgrounds, use that version.
  • Update the required links to point to the proper URLs. The identifier includes links required of any federal website, and these links are specific to a department, agency, or website. We've linked each section below to the guidance on Digital.gov to provide further context.
  • Use the Spanish version if for Spanish-language sites. If you have an official Spanish language website, use the Spanish version of the identifier.
  • Duplicate the logo element if using multiple logos. If you're using multiple logos, duplicate the usa-identifier__logo element and link the image to your image source.
  • If applicable, include any taxpayer disclaimer after the standard text. If the organization must provide a taxpayer expense disclaimer, include it following the "Official website" text, as a separate sentence. For example, "An official website of [Department]. Produced and published at taxpayer expense."
Identifier settings
Variable Description
$theme-identifier-background-color

The background color of the identifier. Use a color of grade 80 or higher, darker than the section that precedes it.

$theme-identifier-font-family

The font family of the identifier

$theme-identifier-identity-domain-color

The color of your domain text in the identifier masthead. This should be grade 20-30 in the same family as the $theme-identifier-background-color.

$theme-identifier-max-width

The maximum width of the content within the identifier. Use the same max-width as your site footer.

$theme-identifier-secondary-link-color

The color of the links in the required links section. This should be grade 20-30 in a gray family.

Identifier variants

This component has no variants.

Package information

  • Package usage: @import usa-identifier
  • Requires: required, global