Internal header

This helps internal HMRC users easily tell the difference between internal and external services.

When to use

Use the internal header when your service will only be used by internal HMRC users.

When not to use

Do not use the internal header for services used by the general public. For public-facing services, use the GOV.UK header.

If you have a user need to show external users that they are dealing with HMRC, then use the HMRC banner.

How it works

You need HMRC Frontend to use this pattern – find out how to install HMRC Frontend. If you use the HMRC Nunjucks macro, you must copy and paste the entire macro into your code.

The internal header should have:

  • the HMRC logo
  • the name of the service
  • a green bar
              <header role="banner" class="hmrc-internal-header">
  <div class="hmrc-internal-header__logo">
    <a href="https://www.gov.uk/government/organisations/hm-revenue-customs" class="hmrc-internal-header__logo-link">
      HM Revenue &amp; Customs
    </a>
  </div>
  <div class="hmrc-internal-header__service-name">
    <a href="#" class="hmrc-internal-header__link">
      Service name
    </a>
  </div>
</header>
            
                <header role="banner" class="hmrc-internal-header">
  <div class="hmrc-internal-header__logo">
    <a href="https://www.gov.uk/government/organisations/hm-revenue-customs" class="hmrc-internal-header__logo-link">
      HM Revenue &amp; Customs
    </a>
  </div>
  <div class="hmrc-internal-header__service-name">
    <a href="#" class="hmrc-internal-header__link">
      Enw’r gwasanaeth
    </a>
  </div>
</header>
              
                {% from "hmrc/components/internal-header/macro.njk"  import hmrcInternalHeader %}


{{ hmrcInternalHeader({
  homepageUrl: 'https://www.gov.uk/government/organisations/hm-revenue-customs',
  serviceName: 'Service name',
  serviceUrl: '#'
}) }}
              
                  {% from "hmrc/components/internal-header/macro.njk"  import hmrcInternalHeader %}


{{ hmrcInternalHeader({
  homepageUrl: 'https://www.gov.uk/government/organisations/hm-revenue-customs',
  serviceName: 'Enw’r gwasanaeth',
  serviceUrl: '#'
}) }}
                

Research

Initial research showed that the internal header helped users recognise they were using an internal service.

We need more research. If you have used the internal header, get in touch to share your research findings.

Discuss the internal header on GitHub