Publishing

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](https://deploy.integration.publishing.service.gov.uk/job/run-rake-task/parambuild/?TARGET_APPLICATION=content-tagger&MACHINE_CLASS=backend&RAKE_TASK=[path-to-facet-yaml]

Related applications

• content-tagger

More in the Publishing section

Learn

• How the draft stack works
• How the topic taxonomy works
• How to tag content with facet values
• What data we expose as schema.org structured data

How to...

• Add a new document type
• Add Historical Accounts
• Add support for a new translation in Whitehall
• Change a government following a general election
• Change a slug and create redirect in Whitehall
• Change a specialist document base path
• Content that doesn't show up correctly in search or list pages
• Deploy emergency publishing banners
• Deploy non-emergency global banner
• Documents are published, but the links aren't up to date
• Find hardcoded markup in GovSpeak
• Help with publishing content
• If documents aren't live after being published
• Make a new document type available to search
• Manually setting the search popularity of content
• Redirect an HTML attachment's URL in Whitehall
• Reindex an Elasticsearch index
• Remove a change note in Whitehall
• Rename a country
• Republish content
• Upload HMRC PAYE files

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.