Skip to main content
Table of contents


How to publish a facet group

Facet values are content items used to categorise other pieces of content. They can be used as filtering criteria in search API queries and used to populate finder results for multiple content formats from across GOV.UK.

Facet values are grouped by Facet which are a collection in a Facet Group.

The corresponding document types for these content items are (facet_value, facet and facet_group). These are related to one another via the relevant links.

Content Tagger is the central place for managing a facet group. It contains rake tasks to draft a facet group, facets and their facet values and publish these content items.

How to import or update a facet group

  1. Define your group in content tagger data
  2. Run the facets:import_facet_group Rake task to import the facet group as draft
  3. Run [the facets:publish_facet_group Rake task to publish the facet group]([path-to-facet-yaml]
This page was last reviewed on 28 October 2019. It needs to be reviewed again on 28 January 2020 by the page owner #govuk-platform-health .
This page was set to be reviewed before 28 January 2020 by the page owner #govuk-platform-health. This might mean the content is out of date.