Skip to main content
Table of contents

Application: collections

Serves GOV.UK navigation pages, browse, topic, step-by-steps & services and information pages.


#govuk-platform-health owns the application and is responsible for updating its dependencies.


The production version of this application is hosted on AWS.

SSH Access (AWS)

gds govuk connect ssh -e integration draft_frontend
gds govuk connect ssh -e staging aws/draft_frontend
gds govuk connect ssh -e production aws/draft_frontend

Run a rake task

Example pages rendered by collections


Warning The content below is pulled in directly from the repository.
Links might not function properly.

Collections serves the GOV.UK navigation pages and organisation pages.


Browse page

Browse page

Topic page

Topic page

Subtopic page

Subtopic page

Services and information page

Services and information page

Taxonomy page

Taxonomy page

Worldwide taxonomy page

Worldwide taxonomy page

Organisation index page

Organisation index page

Organisation page

Organisation page

Step by step page

Step by step page

Live examples


The endpoints and known consumers of this application's APIs are documented in docs/api



  • Curated list: a group of content tagged to a subtopic that has been
    curated into a named list.
  • Topic: a named group of sub-topics. (A deprecated name for this is "specialist sector".)
  • Sub-topic: a group of content within a topic. (A deprecated name for this is
    "specialist sub-sector".)

Browse pages


The taxonomy is surfaced on taxon pages, which group together tagged content for that level of the taxonomy into supergroups on the page, e.g: Guidance and Regulation for Funding and finance for students Each taxon page also shows a grid of sub-topics at the next level of the taxonomy.

Worldwide taxonomy

The worldwide taxonomy is rendered on different types of pages depending on whether the taxon has any children.

For example:

  • Taxon with children: a content item of type taxon that has
    child_taxons links. None of those child taxons' links have child_taxons,
    in which case we display an accordion view:
  • Taxon without children: a content item of type taxon that doesn't have
    child_taxons links. In this case we display an leaf view:
  • Taxon with associated taxons: a content item of type taxon that has
    associated_taxons links. In this case the tagged content of the taxon will
    include content that is directly tagged to it and also content that has been
    tagged to any of the associated taxons.

Technical documentation

This is a public facing Ruby on Rails application that retrieves browse content from APIs and presents it.
There is no underlying persistence layer and all content is retrieved from external sources.

Content for taxon pages

Content for taxon pages is returned by a search in Rummager based on content_ids for world taxonomy pages and content_ids and supergroups for all other taxonomy pages.


  • content-store, provides:
    • Mainstream browse pages (Root, Top and Second level browse pages)
    • Topics
    • Subtopics and their curated lists
  • rummager, provides:
    • latest changes for Topics
    • content tagged to a particular Topic, Mainstream browse page or Organisation
  • email-alert-api, provides:
    • support for subscribing to notifications from a topic

Running the application


The app should start on http://localhost:3070 or on GOV.UK development machines.

./ --live

This will run the app and point it at the production GOV.UK content-store and static instances.

./ --dummy

This will run the app and point it at the dummy content store, which serves the content schema examples and random content.

Running the test suite

Use bundle exec rake to run the test suite, excluding JavaScript

Javascript tests

Use bundle exec rake jasmine:ci to run Jasmine tests


MIT License