1. Component Guide
  2. Notice
Component

Notice

A notice to convey and highlight information

The notice component replaces the notice and withdrawal notice patterns on GOV.UK.

The component accepts either a simple string description_text parameter that it wraps in a paragraph, or a description_govspeak parameter that is rendered through govspeak for more complex HTML layout.

Search for usage of this component on GitHub

How it looks (preview) (preview all)

Statistics release cancelled

How to call this component

<%= render "govuk_publishing_components/components/notice", {
  title: "Statistics release cancelled"
} %>

Accessibility acceptance criteria

The notice must:

  • have a border colour contrast ratio of more than 4.5:1 with its background to be visually distinct.
  • always render headings with associated description content, so there are no isolated heading elements inside the component

Other examples

With description (preview)

Statistics release cancelled

The Oil & Gas Authority launched a new website on 3 October 2016 to reflect its new status as a government company.

This formalises the transfer of the Secretary of State’s regulatory powers in respect of oil and gas to the OGA, and grants it new powers. This website will no longer be updated. Visitors should refer to www.ogauthority.co.uk

<%= render "govuk_publishing_components/components/notice", {
  title: "Statistics release cancelled",
  description: sanitize("<p class=\"govuk-body\">The Oil &amp; Gas Authority launched a new website on 3 October 2016 to reflect its new status as a government company.</p><p class=\"govuk-body\">This formalises the transfer of the Secretary of State’s regulatory powers in respect of oil and gas to the OGA, and grants it new powers. This website will no longer be updated. Visitors should refer to <a class=\"govuk-link\" rel=\"external\" href=\"https://www.ogauthority.co.uk/news-publications/announcements/2015/establishment-of-the-oil-and-gas-authority-1/\">www.ogauthority.co.uk</a></p>")
} %>

With description from a block (preview)

Statistics release update

The Oil & Gas Authority launched a new website on 3 October 2016 to reflect its new status as a government company.

This formalises the transfer of the Secretary of State’s regulatory powers in respect of oil and gas to the OGA, and grants it new powers. This website will no longer be updated. Visitors should refer to www.ogauthority.co.uk

<%= render "govuk_publishing_components/components/notice", {
  title: "Statistics release update"
} do %>
  <p class="govuk-body">The Oil &amp; Gas Authority launched a new website on 3 October 2016 to reflect its new status as a government company.</p><p class="govuk-body">This formalises the transfer of the Secretary of State’s regulatory powers in respect of oil and gas to the OGA, and grants it new powers. This website will no longer be updated. Visitors should refer to <a class="govuk-link" rel="external" href="https://www.ogauthority.co.uk/news-publications/announcements/2015/establishment-of-the-oil-and-gas-authority-1/">www.ogauthority.co.uk</a></p><% end %>

With description text (preview)

Statistics release cancelled

Duplicate, added in error

<%= render "govuk_publishing_components/components/notice", {
  title: "Statistics release cancelled",
  description_text: "Duplicate, added in error"
} %>

With description govspeak (preview)

Statistics release update

The Oil & Gas Authority launched a new website on 3 October 2016 to reflect its new status as a government company.

This formalises the transfer of the Secretary of State’s regulatory powers in respect of oil and gas to the OGA, and grants it new powers. This website will no longer be updated. Visitors should refer to www.ogauthority.co.uk

<%= render "govuk_publishing_components/components/notice", {
  title: "Statistics release update",
  description_govspeak: sanitize("<p>The Oil &amp; Gas Authority launched a new website on 3 October 2016 to reflect its new status as a government company.</p><p>This formalises the transfer of the Secretary of State’s regulatory powers in respect of oil and gas to the OGA, and grants it new powers. This website will no longer be updated. Visitors should refer to <a rel=\"external\" href=\"https://www.ogauthority.co.uk/news-publications/announcements/2015/establishment-of-the-oil-and-gas-authority-1/\">www.ogauthority.co.uk</a></p>")
} %>

With markup in the title (preview)

In some circumstances it may be necessary to include simple markup in the title, such as a link. Note that this will be wrapped in a H2 tag if there is no description included, so be sure that any markup inserted is valid inside that tag (e.g. another heading tag inside a H2 would be invalid).

Advisory Committee on Novel Foods and Processes has a separate website
<%= render "govuk_publishing_components/components/notice", {
  title: sanitize("Advisory Committee on Novel Foods and Processes has a <a href=\"http://www.food.gov.uk/acnfp\">separate website</a>")
} %>

Without title (preview)

Scheduled to publish at 8am on 25 April 2019
Change date
Stop scheduled publishing

<%= render "govuk_publishing_components/components/notice", {
  description_govspeak: sanitize("<p>Scheduled to publish at 8am on 25 April 2019<br/><a href=\"change-date\">Change date</a><br/><a href=\"stop-scheduled-publishing\">Stop scheduled publishing</a></p>")
} %>

With aria live (preview)

Passing the aria live flag to the notice component will read the notice out to users if the notice changes, e.g on form submission the notice may go from hidden to visible.

Your settings have been saved

This is a confirmation message to tell you your settings have been saved

<%= render "govuk_publishing_components/components/notice", {
  title: "Your settings have been saved",
  description_govspeak: sanitize("<p>This is a confirmation message to tell you your settings have been saved</p>"),
  aria_live: true
} %>

With locale (preview)

Passing a lang value allows the content of the notice to be labelled as being a different language from surrounding content. The lang attribute must be set to a valid BCP47 string. A valid code can be the two or three letter language code - for example, English is en or eng, Korean is ko or kor - but if in doubt please check.

This publication was withdrawn on 30 September 2015

This document is no longer current. We published a new version on 30 September 2015.

<%= render "govuk_publishing_components/components/notice", {
  title: "This publication was withdrawn on 30 September 2015",
  description_govspeak: sanitize("<p>This document is no longer current. We published a new version on 30 September 2015.</p>"),
  lang: "en"
} %>